Skip to content

[docs] Adding WASM PHP modules page - #4010

Merged
fellyph merged 11 commits into
trunkfrom
adding-php-wasm-php-module
Jul 27, 2026
Merged

[docs] Adding WASM PHP modules page#4010
fellyph merged 11 commits into
trunkfrom
adding-php-wasm-php-module

Conversation

@fellyph

@fellyph fellyph commented Jul 11, 2026

Copy link
Copy Markdown
Collaborator

This pull request updates the documentation for PHP.wasm in both English and Spanish, clarifying the package structure and usage for Node.js and web environments. It introduces a new architecture page detailing the separation of the shared API, platform adapters, and version-specific binaries, and aligns the Spanish translations with these updates.

Documentation improvements and new content:

  • Added a new page, 06-php-wasm-packages.md, explaining the PHP.wasm package layers, including the shared API (@php-wasm/universal), platform adapters (@php-wasm/node, @php-wasm/web), and version-specific binaries, with guidance on when to use each approach.
  • Updated English docs for Node.js usage to clarify the distinction between platform adapters and version-specific packages, and to provide instructions for minimal installation size and direct loading of a single PHP version. [1] [2]
  • Improved the architecture overview to reference the new PHP.wasm package structure and link to the new documentation. [1] [2]

Spanish and Portuguese translation alignment:

  • Updated the Spanish and Portuguese Node.js usage guide to match the new English documentation, including improved explanations, code comments, and instructions for both platform adapter and direct single-version usage.
  • Added a new Spanish and Portuguese architecture overview page, mirroring the updated English content and providing localized explanations of the PHP.wasm package structure and project tooling.
@fellyph
fellyph requested review from a team, ashfame and Copilot July 11, 2026 08:07
@github-actions github-actions Bot added the [Type] Documentation Improvements or additions to documentation label Jul 11, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a new “PHP.wasm packages” documentation page and updates related architecture + Node.js usage docs across English, Spanish, and Portuguese to explain the package layering (universal API, platform adapters, version-specific binaries) and the “single-version minimal install” option.

Changes:

  • Added a new “PHP.wasm packages” page (EN/ES/pt-BR) documenting the package layers and usage patterns.
  • Updated architecture overviews and the PHP.js module doc to reference the new package-structure page.
  • Updated Node.js usage docs (EN/ES/pt-BR) with guidance on adapter vs direct single-version loading.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
packages/docs/site/sidebars.js Adds the new “PHP.wasm packages” page to the architecture sidebar.
packages/docs/site/docs/developers/23-architecture/06-php-wasm-packages.md New EN page documenting PHP.wasm package layers and usage approaches.
packages/docs/site/docs/developers/23-architecture/04-wasm-php-javascript-module.md Updates EN module doc to reference the shared API and new packages page; fixes wording.
packages/docs/site/docs/developers/23-architecture/01-index.md Updates EN architecture overview component list to point at the new packages page.
packages/docs/site/docs/developers/05-local-development/03-php-wasm-node.md Updates EN Node.js docs with adapter vs single-version guidance and link to new page section.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/23-architecture/06-php-wasm-packages.md New pt-BR translation of the packages page.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/23-architecture/04-wasm-php-javascript-module.md Updates pt-BR module doc to reference the new packages page and loadPHPRuntime().
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/23-architecture/01-index.md Updates pt-BR architecture overview component list and title.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/05-local-development/03-php-wasm-node.md Updates pt-BR Node.js docs with direct single-version guidance and links.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/23-architecture/06-php-wasm-packages.md New ES translation of the packages page.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/23-architecture/04-wasm-php-javascript-module.md New ES translation of the PHP.js module page with the updated messaging.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/23-architecture/01-index.md New ES architecture overview aligned with updated EN structure/tooling notes.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/05-local-development/03-php-wasm-node.md Updates ES Node.js docs with direct single-version guidance and links.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/docs/site/sidebars.js
@fellyph
fellyph merged commit a965f5b into trunk Jul 27, 2026
53 checks passed
@fellyph
fellyph deleted the adding-php-wasm-php-module branch July 27, 2026 13:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Type] Documentation Improvements or additions to documentation

3 participants