Skip to content

New front page (Draft)#1962

Draft
derickr wants to merge 19 commits into
php:previewfrom
derickr:new-front-page
Draft

New front page (Draft)#1962
derickr wants to merge 19 commits into
php:previewfrom
derickr:new-front-page

Conversation

@derickr

@derickr derickr commented Jul 8, 2026

Copy link
Copy Markdown
Member

This draft PR is meant to gather comments for the content on the refreshed landing page for php.net

Please do not merge, as it includes changes to the structure which requires modification on the webserver side.

@derickr derickr mentioned this pull request Jul 9, 2026
@mattstauffer

Copy link
Copy Markdown

OK! What we have in this branch, as I can see:

  • The new front page itself, in public/index.php
  • Frontend support files:
    • include/branch-highlights.inc: frontend-targeted descriptions of highlights of each release
    • public/styles/theme-gst.css and public/js/common.js
    • Many new images
  • A "theme" rendering framework in src/Themes
  • A new footer design (and new body wrapper, if needed, in the header), opt-in per page: include/header.inc and footer.inc only switch behavior when a page sets $config['include_section'] = false / $config['footer_style'] = 'new'
  • An updated version release data layer, founded in src/Releases/Branches.php

Here is a screenshot, since we don't have this on a preview branch:

Full screen

Details

web-php test_

Tasks I think we need to do in order to move forward with this:

  • Review any changes made to the non-template code
  • Review changes to content
  • Review changes to design

I feel like I'm most equipped to be a part of the content and design conversations; as I haven't been really involved in the PHP.net site before, I'd love to leave the first item to others (not sure if @derickr has had a chance to review all this code yet; if not, it'd be great if someone could volunteer to do that.)

I'll leave another comment in a minute about my thoughts, and those I've gathered from others, about content and design.

@mattstauffer

Copy link
Copy Markdown

OK, my thoughts on the content:

What we have right now

It feels like we've actually found a decent amount of consensus and we're ready to move forward with figuring out what really belongs on this home page!

Things that are in the home page right now:

  • Release info
  • Foundation details
  • Minor links to events and social media
  • Links to what's new and downloads
  • A footer with pictures of stuffed elephants

Things that are in the home page in this PR:

  • A short positioning section for PHP
  • A block about PHP 8.5
  • Smaller blocks about PHP 8.4, 8.3, 8.2
  • A block about the Foundation
  • Links to community groups online
  • A block about Composer
  • Details about how the language is developed
  • A footer with links to important pages

What we need to solve in order to move forward

As I've been looking at my notes, and also about the conversations that have happened around this page, and the "why php page", I think these are the questions we're trying to answer as we finalize content:

  • What story should PHP.net tell?
  • Who are we trying to tell that story to?
  • As a result, what jobs must the home page perform?
  • How, if at all, should the home page acknowledge the broader PHP ecosystem?

I think we have to agree on those things (not DEEP IN OUR CORE AGREE 100%, but at least COME TO A GENERAL CONSENSUS) in order to make meaningful progress. But that's hard to do, because we don't have any mechanism for conversations like this yet.

So. I'm going to make a proposal of what I think content should be, and hopefully we can all work through any concerns quickly and actually get this thing designed and shipped! There's a really skilled designer who's agreed to work on this when we're ready (and will share their info once they tell me they're ok with it), but we have to nail down content first.

Quick caveat: yes, I’m on the PHP Foundation board, and yes, helping PHP’s public perception is one of the Foundation’s goals. But neither I nor the Foundation have any authority or desire to dictate this. I’m sharing this as a proposed framework for discussion.

My proposal

(LMK if there's another format I should put this into--Google Docs?--to separate the conversation around it from this GH issue)

My proposal is that we agree on this idea, and then link all decisions back to this:

The PHP.net home page should make a modern developer or technical decision-maker immediately understand that PHP is widely deployed, actively evolving, easy to start with, practical for real production software, and backed by a mature ecosystem and global community.

The audiences

Here's who I think the audiences are, in order:

1. Developers evaluating or re-evaluating PHP

This includes people who think PHP is old, slow, ugly, dead, unserious.

2. Technical decision-makers

CTOs, engineering leads, educators, consultants, bootcamp/university people. People who have the influence to say "no, not (whatever framework), because it's PHP and PHP is old", or "Your perception of PHP being old is outdated, here's why".

3. Existing PHP users

They still need fast paths to downloads, docs, releases, migration guides, events, RFCs, etc. But they should not be the only audience the home page serves, and they're more likely to be willing to navigate a bit to get there.

The "jobs" of the home page

In Jobs to Be Done parlance, we want to know what "jobs" we're "hiring" the home page to do for us. What's it responsible for? Release information is part of that, but it cannot be the whole job. But then, what is it responsible for?

Here's what I think:

1. Position PHP

Answer: “What is PHP today?”

Not “PHP is a popular general-purpose scripting language…”; that doesn't work toward our goals, and you can get the same from Wikipedia. Something closer to:

PHP powers the web — from small sites to large-scale applications — with a modern language, mature tooling, and one of the largest deployment footprints in software.

We can work on the exact copy, but we want a top hero level, confident, anchor sentence.

2. Prove PHP

Answer the common objections (not directly, but through examples and careful language):

  • PHP is old
  • PHP is slow
  • PHP does not scale
  • Nothing important runs on PHP
  • It is hard to hire PHP developers
  • PHP is behind in modern tooling / workflows

Here we can reach for things like usage statistics, modern syntax, recognizable logos/projects, releases with dates, ecosystem information, community. We want to show vitality!

3. Activate the visitor

Answer: “What can I do right now?”

That's CTAs for newcomers like:

  • Get started
  • Install PHP
  • Read the docs
  • Try PHP in the browser
  • See what is new in PHP 8.5
  • Learn modern PHP

We do want to persuade them, but we also want to give them a practical path to running and developing modern PHP.

4. Route existing users

Answer: “Where do I go?”

We want to keep the obvious utilities (whether directly on the home page or in the rich footer):

  • Downloads
  • Documentation
  • Supported versions
  • Migration guides
  • Releases/news
  • Extensions
  • Security
  • Internals/RFCs
  • Community/events

Existing PHP users should not feel like the home page became a marketing brochure and buried the useful stuff.

5. Show life

Answer: “Is PHP alive?”

The home page should visibly show motion:

  • latest stable release
  • release highlights
  • upcoming conferences
  • user groups / community
  • Foundation
  • recent videos/articles/news
  • maybe rotating community/photo content?

This is important because the negative perception we're fighting, summed up, is "PHP is dead". We need to address that on multiple angles.

So what then?

If we come to a place of agreement on something similar to this proposal, I think that lands us with these must-haves:

  • A strong headline/tagline
  • A short “what PHP is today” paragraph
  • Primary CTAs: Get Started, Download/Install, Docs
  • A “What’s new in PHP 8.5” section
  • Modern PHP code examples
  • Some proof that PHP is widely used
  • A clear community/events section
  • A path for newcomers
  • A path for existing developers
  • A path for decision-makers
  • Footer/utility links that preserve current php.net usefulness

and these strong candidates / open questions:

  • Mention of Composer and Packagist
  • Mention of the framework/platform/tool ecosystem
  • A logo cloud or some other similar case-study-like proof
  • “Try PHP in browser” using WASM
  • An explicit “Why PHP?” section, or a link to deeper “Why PHP?” / “PHP for Business” / “PHP for Learners” pages

Next steps

I think the next steps involve conversation around the questions I've asked and the proposal I've shared here, with the hope that we can at minimum agree on a single-sentence declaration of the goals of the home page and a hero hook sentence for the home page. After that, hopefully we can agree on the must-haves, and while any ongoing conversation happens about the nice-to-haves, we can potentially start with the layout and design process.

My ask

Does this feel like the right framework to use for deciding home page content? If not, which part should change: the goal, the audiences, the jobs, or the must-haves?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants