Skip to content

Conversation

@alexandre-daubois
Copy link
Member

@alexandre-daubois alexandre-daubois commented Jun 17, 2025

Here are the docs for both the extensions generator and creating extensions "the old way". I'll take care of the French translation once this version is validated!

Related to #1651

@alexandre-daubois alexandre-daubois force-pushed the ext-docs branch 2 times, most recently from c8d27be to 08060e1 Compare June 19, 2025 08:49
@alexandre-daubois alexandre-daubois force-pushed the ext-docs branch 4 times, most recently from 05e9963 to 01bcb0a Compare June 20, 2025 09:33
@dunglas
Copy link
Member

dunglas commented Jun 25, 2025

IMHO, we should merge both files. WDYT @alexandre-daubois?

@alexandre-daubois
Copy link
Member Author

It was not always easy to write some parts because important things are sometimes dispatched between both pages. So maybe this would help to have a more fluent doc. I'm having a look on how we can merge them 👍

@alexandre-daubois
Copy link
Member Author

Both docs are merged now


```c
PHPAPI int register_internal_extensions(void)
{
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest using helper functions provided by FrankenPHP even for the "manual" code. WDYT?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suits me fine as it showcases FrankenPHP benefits even when creating manually the extension!


We'll start with the manual approach to understand how extensions work under the hood, then show how the generator simplifies the process.

## Manual Implementation
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would start with the easiest option (code generator), then show the advanced way.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR updated

@alexandre-daubois alexandre-daubois force-pushed the ext-docs branch 2 times, most recently from 371f178 to 2c08a7b Compare June 30, 2025 09:06
@dunglas dunglas merged commit 93f2384 into php:main Jun 30, 2025
1 check passed
@dunglas
Copy link
Member

dunglas commented Jun 30, 2025

Thanks!

@dac514
Copy link

dac514 commented Jul 2, 2025

Now that this PR is merged what is the URL to the web page?
I can't find it in the docs yet.
Can you help me?

@alexandre-daubois
Copy link
Member Author

It should be released soon I guess, with the next release of FrankenPHP!

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