From 1a17b2c61872324416d3d0413b75ca402fff27d9 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Thu, 5 Nov 2026 20:54:48 +0000 Subject: [PATCH] Prepare published and unreleased Workflow platform support guidance --- docs/compatibility.md | 25 ++++++++++++++ docs/installation.md | 33 ++++++++++++++++-- docs/laravel-adoption.md | 12 ++++--- docs/migration.md | 18 ++++++++++ .../current/compatibility.md | 25 ++++++++++++++ .../current/installation.md | 34 +++++++++++++++++-- .../current/laravel-adoption.md | 12 +++++-- .../current/migration.md | 19 +++++++++++ i18n/de/source-hashes.json | 8 ++--- .../current/compatibility.md | 25 ++++++++++++++ .../current/installation.md | 34 +++++++++++++++++-- .../current/laravel-adoption.md | 15 +++++--- .../current/migration.md | 20 +++++++++++ i18n/es/source-hashes.json | 8 ++--- .../current/compatibility.md | 25 ++++++++++++++ .../current/installation.md | 34 +++++++++++++++++-- .../current/laravel-adoption.md | 14 +++++--- .../current/migration.md | 20 +++++++++++ i18n/fr/source-hashes.json | 8 ++--- .../current/compatibility.md | 22 ++++++++++++ .../current/installation.md | 32 +++++++++++++++-- .../current/laravel-adoption.md | 10 ++++-- .../current/migration.md | 16 +++++++++ i18n/ja/source-hashes.json | 8 ++--- .../current/compatibility.md | 25 ++++++++++++++ .../current/installation.md | 34 +++++++++++++++++-- .../current/laravel-adoption.md | 14 +++++--- .../current/migration.md | 19 +++++++++++ i18n/pt-BR/source-hashes.json | 8 ++--- .../current/compatibility.md | 24 +++++++++++++ .../current/installation.md | 34 +++++++++++++++++-- .../current/laravel-adoption.md | 12 ++++--- .../current/migration.md | 19 +++++++++++ i18n/uk/source-hashes.json | 8 ++--- .../current/compatibility.md | 21 ++++++++++++ .../current/installation.md | 30 ++++++++++++++-- .../current/laravel-adoption.md | 9 +++-- .../current/migration.md | 13 +++++++ i18n/zh-Hans/source-hashes.json | 8 ++--- 39 files changed, 682 insertions(+), 73 deletions(-) diff --git a/docs/compatibility.md b/docs/compatibility.md index 8abee51ff86..c1f8053848d 100644 --- a/docs/compatibility.md +++ b/docs/compatibility.md @@ -135,6 +135,31 @@ These documents add per-package detail under the rules on this page: `durable-workflow/sdk-rust`. Authoritative for the `durable-workflow` crate public API and its package compatibility declaration. +## Embedded PHP and Laravel support {#embedded-php-and-laravel-support} + +The embedded package's platform requirements come from its published Composer +and upgrade manifests. A source merge is not published support or installed +qualification. + +| Workflow line | PHP constraint | Laravel constraint | Authority | +| --- | --- | --- | --- | +| Published 2.20.4 | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [Published 2.20.4 manifest](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21, unreleased | `^8.2` | `^12.69.0\|^13.30.0` | [Intended source](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json); actual publication and Release Verification are still required | + +Laravel 10 permits PHP 8.1, Laravel 11/12 require PHP 8.2, and Laravel 13 +requires PHP 8.3. A declared Composer range does not qualify every interpreter +or database combination. Prepare the application platform using the +[2.21 upgrade guidance](/docs/installation/#preparing-for-workflow-2-21). +Laravel 9 applications remain on their compatible 2.16.x line until the +framework is upgraded. The historical 1.x contract is unchanged. + +The framework-neutral PHP SDK retains its independent PHP `^8.1` requirement. +Its [Laravel service bridge](https://php.durable-workflow.com/frameworks/laravel/) +follows the SDK's own published contract. Workflow's planned platform change +does not narrow that bridge early or change standalone Server, Python or Rust +requirements. No worker-protocol or durable-history version is changed by this +platform support boundary. + ## Release Rules These rules apply to every public surface family above. They are reproduced in diff --git a/docs/installation.md b/docs/installation.md index 0c17d5ff700..5dd03925e84 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -19,8 +19,37 @@ the embedded Laravel path. ## Requirements -- PHP 8.1 or later -- Laravel 9 or later +The published Workflow 2.20.x line requires: + +- PHP `^8.1` +- Laravel 10–13 at the declared minimum versions in the + [package manifest](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + +Laravel 11 and 12 require PHP 8.2 or newer. Laravel 13 requires PHP 8.3 or +newer. See [Version Compatibility](/docs/compatibility/#embedded-php-and-laravel-support) +for the exact framework constraints and the separate PHP SDK boundary. + +### Preparing for Workflow 2.21 {#preparing-for-workflow-2-21} + +:::info Unreleased support change + +Workflow 2.21 source requires PHP `^8.2` and Laravel `^12.69.0|^13.30.0`. +It is not published or Release-Verified yet. The install command below still +selects a published artifact. Source integration does not change that authority. + +::: + +Upgrade PHP 8.1 applications and Laravel 10/11 applications to a supported +platform before taking 2.21. Laravel 13 still needs PHP 8.3 or newer. Apply the +platform update to web, CLI and worker processes, retaining the existing 2.20.x +application lock while preparing and testing the upgrade. An explicit 2.21 +requirement must refuse an unsupported platform. Keep Composer platform checks +and advisory blocking enabled. Retaining 2.20.x does not extend upstream +security support for the old platform. + +This support change introduces no schema, history or protocol migration. +Existing v1 runs keep their v1 owner. The [migration procedure](/docs/migration/) +still governs draining or coexistence. Check [Database Compatibility](./polyglot/database-support.md) for the embedded and Server declarations, exact tested configurations and qualification limits. diff --git a/docs/laravel-adoption.md b/docs/laravel-adoption.md index 035c76dd3fa..d7a07025c1e 100644 --- a/docs/laravel-adoption.md +++ b/docs/laravel-adoption.md @@ -41,9 +41,13 @@ choosing the transition policy here. | Stable v1 Laravel | PHP SDK service mode | Laravel should keep dependency injection, configuration, Artisan, logging, events, and test fakes, but Cloud or Server should own durable state. | Install `durable-workflow/sdk` as a separate service client/worker boundary. v1 history and durable Laravel queue jobs stay on the v1 runtime until terminal. | | 2.0 embedded Laravel | PHP SDK service mode | The application should stop owning the orchestration runtime or needs a shared/polyglot runtime boundary. | Route new starts to the service runtime after its workers are ready. Drain embedded runs where they started, or use the explicit eligible embedded-v2 import procedure for self-hosted Server. | -The PHP SDK bridge and the embedded package support Laravel 9 through 13 on -their compatible PHP versions. A supported v1 application can therefore choose -either destination without an unrelated Laravel upgrade. +Check each destination's platform requirements before choosing it. The +[embedded installation guide](/docs/installation/#requirements) covers the +published 2.20.x requirements and the unreleased 2.21 upgrade boundary. The +[PHP SDK Laravel guide](https://php.durable-workflow.com/frameworks/laravel/) +owns the separate service bridge contract. The bare SDK's PHP `^8.1` floor +does not establish every framework combination. A supported v1 host can still +need a PHP or Laravel upgrade before moving to its chosen destination. ## Compare the ownership boundary @@ -328,7 +332,7 @@ the published PHP SDK artifact authority, not copied from a point release: composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9 through 13 auto-discover the provider. Publish the package +Supported Laravel releases auto-discover the SDK provider. Publish the package configuration and list the attributed handler classes: diff --git a/docs/migration.md b/docs/migration.md index 58d5c047b06..9f3af20431e 100644 --- a/docs/migration.md +++ b/docs/migration.md @@ -21,6 +21,24 @@ a self-hosted Server through the PHP SDK in the [Laravel adoption and runtime transition guide](/docs/laravel-adoption/). This page then provides the detailed v1-to-v2 embedded package procedure. +## Check the target platform {#check-the-target-platform} + +Match the published target package's [PHP and Laravel requirements](/docs/installation/#requirements) +before changing Composer constraints. Stable v1 support does not imply support +for the same host in current embedded v2. In particular, Laravel 9 applications +need a framework upgrade before taking the published 2.20.x line. + +The [2.21 preparation guidance](/docs/installation/#preparing-for-workflow-2-21) +describes the planned removal of PHP 8.1 and Laravel 10/11 support. That line +is not published or Release-Verified yet. Keep the existing 2.20.x application +lock while preparing the platform upgrade. Older releases do not extend +upstream security support. The bare PHP SDK and its Laravel bridge have their +own published requirements. + +This platform change introduces no schema, history or protocol migration. +Existing v1 history remains owned by v1. The drain, coexistence and rollback +rules below still apply. A Composer change never migrates a run. + ## Upgrade procedure ### Before upgrading diff --git a/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md index 9d6f5158238..2a5fbdfd1df 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/compatibility.md @@ -96,6 +96,31 @@ Diese Dokumente ergänzen paketbezogene Details unter den Regeln dieser Seite: - Python-SDK: `README.md` in `durable-workflow/sdk-python`. Maßgeblich für die öffentliche API des Pakets `durable_workflow`. - Rust-SDK: `README.md` und `[package.metadata.durable-workflow]` in `durable-workflow/sdk-rust`. Maßgeblich für die öffentliche API der Crate `durable-workflow` und ihre Paketkompatibilitätserklärung. +## PHP- und Laravel-Unterstützung im eingebetteten Modus {#embedded-php-and-laravel-support} + +Die Plattformanforderungen des eingebetteten Pakets stammen aus seinen +veröffentlichten Composer- und Upgrade-Manifesten. Ein Quellcode-Merge belegt +weder veröffentlichten Support noch die Qualifikation einer Installation. + +| Workflow-Reihe | PHP-Vorgabe | Laravel-Vorgabe | Autorität | +| --- | --- | --- | --- | +| 2.20.4 veröffentlicht | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [Veröffentlichtes 2.20.4-Manifest](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21, unveröffentlicht | `^8.2` | `^12.69.0\|^13.30.0` | [Geplanter Quellstand](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json); tatsächliche Veröffentlichung und Release Verification stehen aus | + +Laravel 10 erlaubt PHP 8.1, Laravel 11/12 benötigen PHP 8.2 und Laravel 13 +benötigt PHP 8.3. Ein deklarierter Composer-Bereich qualifiziert nicht jede +Interpreter-/Datenbankkombination. Bereiten Sie die Plattform anhand der +[Upgrade-Anleitung für 2.21](/docs/installation/#preparing-for-workflow-2-21) vor. +Laravel-9-Anwendungen bleiben bis zum Framework-Upgrade auf ihrer kompatiblen +Reihe 2.16.x. Der historische 1.x-Vertrag bleibt unverändert. + +Das frameworkunabhängige PHP-SDK behält seine eigene PHP-Vorgabe `^8.1`. +Seine [Laravel-Bridge im Dienstmodus](https://php.durable-workflow.com/frameworks/laravel/) +folgt dem veröffentlichten SDK-Vertrag. Der geplante Plattformwechsel von Workflow +schränkt diese Bridge nicht vorzeitig ein und ändert keine Anforderungen von +Standalone-Server, Python oder Rust. Diese Plattformgrenze ändert keine +Version des Worker-Protokolls oder des dauerhaften Verlaufs. + ## Veröffentlichungsregeln {#release-rules} Diese Regeln gelten für jede obige öffentliche Schnittstellenfamilie. Sie sind im JSON-Spiegel unter `release_rules` wiedergegeben. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/installation.md b/i18n/de/docusaurus-plugin-content-docs/current/installation.md index 77575b1ce38..08321a9b551 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/installation.md @@ -12,8 +12,38 @@ Wenn Sie zwischen der Einbettung des Pakets und dem eigenständigen Server wähl ## Voraussetzungen {#requirements} -- PHP 8.1 oder neuer -- Laravel 9 oder neuer +Die veröffentlichte Workflow-Reihe 2.20.x benötigt: + +- PHP `^8.1` +- Laravel 10–13 mit den deklarierten Mindestversionen aus dem + [Paketmanifest](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + +Laravel 11 und 12 benötigen mindestens PHP 8.2, Laravel 13 mindestens PHP 8.3. +Die [Versionskompatibilität](/docs/compatibility/#embedded-php-and-laravel-support) +nennt die genauen Vorgaben und die getrennte Grenze des PHP-SDK. + +### Workflow 2.21 vorbereiten {#preparing-for-workflow-2-21} + +:::info Noch nicht veröffentlichte Supportänderung + +Der Quellstand für Workflow 2.21 benötigt PHP `^8.2` und Laravel `^12.69.0|^13.30.0`. +Er ist noch nicht veröffentlicht oder durch Release Verification geprüft. Der +Installationsbefehl unten wählt weiterhin ein veröffentlichtes Artefakt; +ein Quellcode-Merge ändert diese Autorität nicht. + +::: + +Aktualisieren Sie Anwendungen mit PHP 8.1 oder Laravel 10/11 vor 2.21 auf eine +unterstützte Plattform. Laravel 13 benötigt weiterhin mindestens PHP 8.3. +Aktualisieren Sie Web-, CLI- und Worker-Prozesse und bewahren Sie während +Vorbereitung und Tests die bestehende 2.20.x-Lockdatei auf. Eine explizite +2.21-Anforderung muss eine nicht unterstützte Plattform ablehnen. Lassen Sie +Composers Plattformprüfung und Sicherheitshinweis-Sperren aktiv. Das Beibehalten +von 2.20.x verlängert nicht die vorgelagerte Sicherheitsunterstützung für PHP oder Laravel. + +Diese Supportänderung führt keine Schema-, Verlaufs- oder Protokollmigration +ein. Bestehende v1-Läufe bleiben bei v1; das +[Migrationsverfahren](/docs/migration/) regelt weiterhin Drain oder Koexistenz. Prüfen Sie die [Datenbankkompatibilität](./polyglot/database-support.md) für eingebettete und Server-Deklarationen, genaue Testkonfigurationen und Qualifikationsgrenzen. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md index a88413fc9cd..f6fe43abc8a 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -34,7 +34,14 @@ Für ein unmittelbares v1-Upgrade auf Paketebene halten Sie den ausführlichen [ | Stabiles v1-Laravel | PHP-SDK-Dienstmodus | Laravel soll Dependency Injection, Konfiguration, Artisan, Logging, Ereignisse und Test-Fakes behalten, Cloud oder Server aber den dauerhaften Zustand verwalten. | `durable-workflow/sdk` als separate Dienstclient-/Worker-Grenze installieren. v1-Historie und dauerhafte Laravel-Warteschlangenjobs bleiben bis zum terminalen Zustand auf der v1-Laufzeit. | | Eingebettetes 2.0-Laravel | PHP-SDK-Dienstmodus | Die Anwendung soll die Orchestrierungslaufzeit nicht mehr verwalten oder benötigt eine gemeinsame/mehrsprachige Laufzeitgrenze. | Neue Starts nach Bereitschaft der Worker an die Dienstlaufzeit leiten. Eingebettete Läufe an ihrem Ursprungsort abschließen lassen oder für selbst gehosteten Server das explizite Importverfahren für geeignete eingebettete v2-Läufe verwenden. | -Die PHP-SDK-Bridge und das eingebettete Paket unterstützen Laravel 9 bis 13 mit ihren kompatiblen PHP-Versionen. Eine unterstützte v1-Anwendung kann daher beide Ziele ohne sachfremdes Laravel-Upgrade wählen. +Prüfen Sie vor der Auswahl die Plattformanforderungen jedes Ziels. Die +[Installationsanleitung für den eingebetteten Modus](/docs/installation/#requirements) +beschreibt die veröffentlichten 2.20.x-Anforderungen und die Upgrade-Grenze +für das noch unveröffentlichte 2.21. Der +[Laravel-Leitfaden des PHP-SDK](https://php.durable-workflow.com/frameworks/laravel/) +ist für den getrennten Dienstvertrag maßgeblich; die PHP-Untergrenze `^8.1` +des SDK allein belegt nicht jede Framework-Kombination. Auch ein unterstützter +v1-Host kann vor dem Wechsel ein PHP- oder Laravel-Upgrade benötigen. ## Verantwortungsgrenzen vergleichen {#compare-the-ownership-boundary} @@ -294,7 +301,8 @@ Installieren Sie das unabhängig veröffentlichte SDK-Paket. Dieser Befehl wird composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9 bis 13 erkennt den Provider automatisch. Veröffentlichen Sie die Paketkonfiguration und listen Sie die mit Attributen versehenen Handlerklassen auf: +Unterstützte Laravel-Versionen erkennen den SDK-Provider automatisch. +Veröffentlichen Sie die Paketkonfiguration und listen Sie die mit Attributen versehenen Handlerklassen auf: ```php diff --git a/i18n/de/docusaurus-plugin-content-docs/current/migration.md b/i18n/de/docusaurus-plugin-content-docs/current/migration.md index d92708c2fb1..10aa38d99a3 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/migration.md @@ -17,6 +17,25 @@ keywords: Dieser Leitfaden beschreibt die wichtigsten Änderungen beim Upgrade einer bestehenden Laravel-v1-Anwendung auf v2. Entscheiden Sie zuerst im [Leitfaden zur Laravel-Einführung und zum Laufzeitwechsel](/docs/laravel-adoption/), ob Laravel die Laufzeit weiter verwaltet oder über das PHP-SDK Cloud oder einen selbst gehosteten Server anspricht. Diese Seite beschreibt anschließend das detaillierte Verfahren für das eingebettete Paket von v1 zu v2. +## Zielplattform prüfen {#check-the-target-platform} + +Prüfen Sie vor dem Ändern der Composer-Vorgaben die +[PHP- und Laravel-Anforderungen](/docs/installation/#requirements) des +veröffentlichten Zielpakets. Der stabile v1-Support bedeutet nicht, dass derselbe +Host im aktuellen eingebetteten v2 unterstützt wird. Insbesondere benötigen +Laravel-9-Anwendungen vor der veröffentlichten Reihe 2.20.x ein Framework-Upgrade. + +Die [Vorbereitung auf 2.21](/docs/installation/#preparing-for-workflow-2-21) +beschreibt das geplante Supportende für PHP 8.1 und Laravel 10/11. Diese Reihe +ist noch nicht veröffentlicht oder durch Release Verification geprüft. +Bewahren Sie bei der Plattformvorbereitung die bestehende 2.20.x-Lockdatei auf; +ältere Versionen verlängern keine vorgelagerte Sicherheitsunterstützung. +Das PHP-SDK allein und seine Laravel-Bridge haben eigene veröffentlichte Anforderungen. + +Diese Plattformänderung führt keine Schema-, Verlaufs- oder Protokollmigration +ein. Bestehender v1-Verlauf bleibt bei v1. Die folgenden Regeln zu Drain, +Koexistenz und Rollback gelten weiter; eine Composer-Änderung migriert nie einen Lauf. + ## Upgrade-Verfahren {#upgrade-procedure} ### Vor dem Upgrade {#before-upgrading} diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/de/source-hashes.json +++ b/i18n/de/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91", diff --git a/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md index 4b88061bc87..384cd49e9f2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/compatibility.md @@ -135,6 +135,31 @@ Estos documentos añaden detalles de cada paquete siguiendo las reglas de esta p `durable-workflow/sdk-rust`. Referencia de la API pública del crate `durable-workflow` y de su declaración de compatibilidad del paquete. +## Soporte de PHP y Laravel en modo integrado {#embedded-php-and-laravel-support} + +Los requisitos de plataforma del paquete integrado proceden de sus manifiestos +publicados de Composer y actualización. Integrar código fuente no demuestra +soporte publicado ni cualificación de una instalación. + +| Serie Workflow | Restricción de PHP | Restricción de Laravel | Autoridad | +| --- | --- | --- | --- | +| 2.20.4 publicada | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [Manifiesto publicado de 2.20.4](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21, no publicada | `^8.2` | `^12.69.0\|^13.30.0` | [Código previsto](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json); aún se requieren la publicación real y Release Verification | + +Laravel 10 admite PHP 8.1, Laravel 11/12 requieren PHP 8.2 y Laravel 13 requiere +PHP 8.3. Un rango de Composer declarado no cualifica todas las combinaciones +de intérprete y base de datos. Prepara la plataforma con la +[guía de actualización a 2.21](/docs/installation/#preparing-for-workflow-2-21). +Las aplicaciones Laravel 9 permanecen en su serie compatible 2.16.x hasta +actualizar el framework. El contrato histórico 1.x no cambia. + +El SDK PHP independiente del framework conserva su requisito PHP `^8.1`. +Su [puente Laravel en modo servicio](https://php.durable-workflow.com/frameworks/laravel/) +sigue su propio contrato publicado. El cambio previsto de Workflow no reduce +antes de tiempo ese soporte ni cambia los requisitos de Server independiente, +Python o Rust. Este límite de plataforma no cambia ninguna versión del +protocolo de workers ni del historial duradero. + ## Reglas de publicación {#release-rules} Estas reglas se aplican a todas las familias públicas anteriores. Se reproducen diff --git a/i18n/es/docusaurus-plugin-content-docs/current/installation.md b/i18n/es/docusaurus-plugin-content-docs/current/installation.md index 189260f4c8e..e9466827993 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/installation.md @@ -19,8 +19,38 @@ Esta página describe la integración en Laravel. ## Requisitos {#requirements} -- PHP 8.1 o posterior -- Laravel 9 o posterior +La serie publicada Workflow 2.20.x requiere: + +- PHP `^8.1` +- Laravel 10–13 con los mínimos declarados en el + [manifiesto del paquete](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + +Laravel 11 y 12 requieren PHP 8.2 o posterior; Laravel 13 requiere PHP 8.3 o +posterior. Consulta [Compatibilidad de versiones](/docs/compatibility/#embedded-php-and-laravel-support) +para las restricciones exactas y el límite independiente del SDK PHP. + +### Prepararse para Workflow 2.21 {#preparing-for-workflow-2-21} + +:::info Cambio de soporte aún no publicado + +El código de Workflow 2.21 requiere PHP `^8.2` y Laravel `^12.69.0|^13.30.0`. +Todavía no está publicado ni ha superado Release Verification. El comando de +instalación de abajo sigue seleccionando un artefacto publicado; integrar el +código fuente no cambia esa autoridad. + +::: + +Actualiza las aplicaciones con PHP 8.1 o Laravel 10/11 a una plataforma +compatible antes de adoptar 2.21. Laravel 13 sigue necesitando PHP 8.3 o +posterior. Actualiza los procesos web, CLI y workers, conservando el archivo +de bloqueo de la aplicación 2.20.x mientras preparas y pruebas la actualización. +Una solicitud explícita de 2.21 debe rechazar una plataforma no compatible; +mantén activas las comprobaciones de plataforma y el bloqueo por avisos de +Composer. Conservar 2.20.x no amplía el soporte de seguridad de PHP o Laravel. + +Este cambio de soporte no introduce una migración de esquema, historial o +protocolo. Las ejecuciones v1 siguen perteneciendo a v1; el +[procedimiento de migración](/docs/migration/) sigue regulando el vaciado o la coexistencia. Consulte [Compatibilidad de bases de datos](./polyglot/database-support.md) para las declaraciones de modo embebido y Server, configuraciones exactas probadas y límites de cualificación. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md index 697c2560cb5..fe1b83a29c4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -41,9 +41,14 @@ elegir aquí la política de transición. | Laravel v1 estable | SDK PHP en modo servicio | Laravel debe conservar inyección de dependencias, configuración, Artisan, registros, eventos y simulaciones de prueba, pero Cloud o Server deben poseer el estado duradero. | Instala `durable-workflow/sdk` como límite separado de cliente/worker. El historial v1 y los trabajos duraderos de colas Laravel permanecen en v1 hasta terminar. | | Laravel 2.0 integrado | SDK PHP en modo servicio | La aplicación debe dejar de operar la orquestación o necesita un entorno compartido/políglota. | Dirige los nuevos inicios al servicio tras preparar sus workers. Drena las ejecuciones integradas en origen o usa la importación explícita de ejecuciones v2 elegibles a Server autogestionado. | -El puente del SDK PHP y el paquete integrado admiten Laravel 9 a 13 con sus -versiones PHP compatibles. Una aplicación v1 admitida puede elegir cualquiera -de los destinos sin una actualización de Laravel ajena a esta transición. +Comprueba los requisitos de cada destino antes de elegirlo. La +[guía de instalación integrada](/docs/installation/#requirements) cubre los +requisitos publicados de 2.20.x y el límite de actualización de 2.21 aún no +publicada. La [guía Laravel del SDK PHP](https://php.durable-workflow.com/frameworks/laravel/) +es la autoridad independiente del puente de servicio; el mínimo PHP `^8.1` +del SDK básico no demuestra compatibilidad con todas las combinaciones de +framework. Un host v1 compatible puede necesitar actualizar PHP o Laravel +antes de pasar al destino elegido. ## Compara los límites de responsabilidad {#compare-the-ownership-boundary} @@ -327,8 +332,8 @@ autoridad del artefacto SDK PHP publicado, sin copiar una versión puntual: composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9 a 13 descubre automáticamente el proveedor. Publica la configuración y -enumera las clases de manejadores con atributos: +Las versiones compatibles de Laravel descubren automáticamente el provider del SDK. +Publica la configuración del paquete y enumera las clases de handlers con atributos: ```php diff --git a/i18n/es/docusaurus-plugin-content-docs/current/migration.md b/i18n/es/docusaurus-plugin-content-docs/current/migration.md index ebc586df6a6..8172b7ce089 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/migration.md @@ -21,6 +21,26 @@ Cloud o Server mediante el SDK PHP en la [guía de adopción y transición de Laravel](/docs/laravel-adoption/). Esta página detalla después la actualización del paquete integrado de v1 a v2. +## Comprueba la plataforma de destino {#check-the-target-platform} + +Antes de cambiar las restricciones de Composer, comprueba los +[requisitos de PHP y Laravel](/docs/installation/#requirements) del paquete +publicado de destino. El soporte estable v1 no implica que ese mismo host sea +compatible con v2 integrado actual. En particular, una aplicación Laravel 9 +debe actualizar el framework antes de adoptar la serie publicada 2.20.x. + +La [preparación de 2.21](/docs/installation/#preparing-for-workflow-2-21) +describe la retirada prevista del soporte de PHP 8.1 y Laravel 10/11. Esa serie +aún no está publicada ni ha superado Release Verification. Conserva el archivo +de bloqueo 2.20.x de la aplicación mientras preparas la plataforma; las versiones +anteriores no amplían el soporte de seguridad del proveedor. El SDK PHP básico +y su puente Laravel tienen sus propios requisitos publicados. + +Este cambio de plataforma no introduce una migración de esquema, historial o +protocolo. v1 conserva la propiedad del historial v1. Las reglas de vaciado, +coexistencia y reversión de abajo siguen siendo necesarias; cambiar Composer +nunca migra una ejecución. + ## Procedimiento de actualización {#upgrade-procedure} ### Antes de actualizar {#before-upgrading} diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/es/source-hashes.json +++ b/i18n/es/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91", diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md index c55b4551b76..0a08db1c337 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/compatibility.md @@ -131,6 +131,31 @@ Ces documents précisent les règles de cette page pour chaque paquet : `durable-workflow/sdk-rust`. Référence pour l'API publique de la crate `durable-workflow` et sa déclaration de compatibilité. +## Prise en charge PHP et Laravel embarqués {#embedded-php-and-laravel-support} + +Les exigences de plateforme du paquet embarqué viennent de ses manifestes +publiés Composer et de mise à niveau. Une intégration de code source ne prouve +ni un support publié ni la qualification d'une installation. + +| Branche Workflow | Contrainte PHP | Contrainte Laravel | Autorité | +| --- | --- | --- | --- | +| 2.20.4 publiée | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [Manifeste publié 2.20.4](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21, non publiée | `^8.2` | `^12.69.0\|^13.30.0` | [Source prévue](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json) ; publication réelle et Release Verification encore requises | + +Laravel 10 permet PHP 8.1, Laravel 11/12 nécessitent PHP 8.2 et Laravel 13 +nécessite PHP 8.3. Une plage Composer déclarée ne qualifie pas chaque couple +interpréteur/base de données. Préparez la plateforme avec le +[guide de mise à niveau 2.21](/docs/installation/#preparing-for-workflow-2-21). +Les applications Laravel 9 restent sur leur branche compatible 2.16.x jusqu'à +la mise à niveau du framework. Le contrat historique 1.x reste inchangé. + +Le SDK PHP indépendant du framework conserve son exigence PHP `^8.1`. +Son [pont Laravel en mode service](https://php.durable-workflow.com/frameworks/laravel/) +suit son propre contrat publié. Le changement prévu de Workflow ne réduit pas +prématurément ce support et ne change pas les exigences de Server autonome, +Python ou Rust. Cette limite de plateforme ne change aucune version du +protocole worker ou de l'historique durable. + ## Règles de publication {#release-rules} Ces règles s'appliquent à toutes les familles publiques ci-dessus. Elles sont diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/installation.md b/i18n/fr/docusaurus-plugin-content-docs/current/installation.md index 05f970de35f..ea2618f0778 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/installation.md @@ -12,8 +12,38 @@ Si vous hésitez entre l’intégration du package et un Server indépendant, co ## Prérequis {#requirements} -- PHP 8.1 ou ultérieur -- Laravel 9 ou ultérieur +La branche publiée Workflow 2.20.x nécessite : + +- PHP `^8.1` +- Laravel 10–13 aux versions minimales déclarées dans le + [manifeste du paquet](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + +Laravel 11 et 12 nécessitent PHP 8.2 ou ultérieur ; Laravel 13 nécessite PHP 8.3 +ou ultérieur. Consultez la [compatibilité des versions](/docs/compatibility/#embedded-php-and-laravel-support) +pour les contraintes exactes et la limite distincte du SDK PHP. + +### Préparer Workflow 2.21 {#preparing-for-workflow-2-21} + +:::info Changement de prise en charge non publié + +Le code source de Workflow 2.21 nécessite PHP `^8.2` et Laravel `^12.69.0|^13.30.0`. +Il n'est pas encore publié et n'a pas passé Release Verification. La commande +ci-dessous sélectionne toujours un artefact publié ; l'intégration du code +source ne change pas cette autorité. + +::: + +Mettez les applications PHP 8.1 ou Laravel 10/11 à niveau vers une plateforme +prise en charge avant d'adopter 2.21. Laravel 13 nécessite toujours PHP 8.3 ou +ultérieur. Mettez à jour les processus web, CLI et workers, en conservant le +fichier de verrouillage 2.20.x pendant la préparation et les tests. Une demande +explicite de 2.21 doit refuser une plateforme non prise en charge ; gardez les +contrôles de plateforme et le blocage des avis de sécurité Composer actifs. +Conserver 2.20.x ne prolonge pas le support de sécurité amont de PHP ou Laravel. + +Ce changement n'introduit aucune migration de schéma, d'historique ou de +protocole. Les exécutions v1 restent la propriété de v1 ; la +[procédure de migration](/docs/migration/) régit toujours leur vidage ou coexistence. Consultez la [compatibilité des bases de données](./polyglot/database-support.md) pour les déclarations embarquées et Server, configurations exactes testées et limites de qualification. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md index e12469a27e7..3fb6a3f2932 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -41,9 +41,13 @@ choisi ici votre politique de transition. | Laravel v1 stable | SDK PHP en mode service | Laravel doit conserver injection de dépendances, configuration, Artisan, journaux, événements et simulations de test, mais Cloud ou Server doit posséder l'état durable. | Installez `durable-workflow/sdk` comme frontière distincte de client/worker de service. L'historique v1 et les jobs Laravel durables restent sur le runtime v1 jusqu'à leur état terminal. | | Laravel 2.0 embarqué | SDK PHP en mode service | L'application doit cesser de posséder le runtime d'orchestration ou nécessite un runtime partagé ou polyglotte. | Dirigez les nouveaux démarrages vers le service une fois ses workers prêts. Terminez les exécutions embarquées là où elles ont démarré, ou utilisez la procédure explicite d'import embarqué-v2 éligible pour Server auto-hébergé. | -Le pont du SDK PHP et le paquet embarqué prennent en charge Laravel 9 à 13 sur -leurs versions PHP compatibles. Une application v1 prise en charge peut donc -choisir l'une ou l'autre sans mise à niveau Laravel sans rapport avec la transition. +Vérifiez les exigences de chaque destination avant de la choisir. Le +[guide d'installation embarquée](/docs/installation/#requirements) décrit les +exigences publiées 2.20.x et la limite de mise à niveau de 2.21 non publiée. +Le [guide Laravel du SDK PHP](https://php.durable-workflow.com/frameworks/laravel/) +fait autorité pour le pont de service distinct ; le minimum PHP `^8.1` du SDK +seul ne qualifie pas toutes les combinaisons de framework. Un hôte v1 pris en +charge peut devoir mettre à niveau PHP ou Laravel avant de changer de destination. ## Comparer les responsabilités {#compare-the-ownership-boundary} @@ -330,8 +334,8 @@ partir de la référence d'artefacts SDK PHP publiée, sans recopier une version composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9 à 13 découvrent automatiquement le fournisseur. Publiez la -configuration et listez les classes de gestionnaire munies d'attributs : +Les versions Laravel prises en charge découvrent automatiquement le fournisseur du SDK. +Publiez la configuration du paquet et listez les classes de gestionnaire munies d'attributs : ```php diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/migration.md b/i18n/fr/docusaurus-plugin-content-docs/current/migration.md index 4bf195f9a39..9abd26d6f12 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/migration.md @@ -21,6 +21,26 @@ runtime ou se connecte à Cloud ou Server auto-hébergé via le SDK PHP dans le [guide d'adoption Laravel et de transition du runtime](/docs/laravel-adoption/). Cette page détaille ensuite la migration du paquet embarqué v1 vers v2. +## Vérifier la plateforme cible {#check-the-target-platform} + +Vérifiez les [exigences PHP et Laravel](/docs/installation/#requirements) du +paquet cible publié avant de changer les contraintes Composer. Le support +stable v1 n'implique pas que le même hôte soit pris en charge en v2 embarquée +actuelle. Une application Laravel 9 doit notamment mettre le framework à niveau +avant d'adopter la branche publiée 2.20.x. + +La [préparation de 2.21](/docs/installation/#preparing-for-workflow-2-21) +décrit le retrait prévu de PHP 8.1 et Laravel 10/11. Cette branche n'est pas +encore publiée et n'a pas passé Release Verification. Conservez le fichier de +verrouillage 2.20.x pendant la préparation ; les versions antérieures ne +prolongent pas le support de sécurité amont. Le SDK PHP seul et son pont +Laravel ont leurs propres exigences publiées. + +Ce changement n'introduit aucune migration de schéma, d'historique ou de +protocole. L'historique v1 reste la propriété de v1. Les règles de vidage, +coexistence et retour arrière ci-dessous restent applicables ; un changement +Composer ne migre jamais une exécution. + ## Procédure de mise à niveau {#upgrade-procedure} ### Avant la mise à niveau {#before-upgrading} diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/fr/source-hashes.json +++ b/i18n/fr/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91", diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md index 6a815a87f0e..bf3e69827f7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/compatibility.md @@ -96,6 +96,28 @@ Durable Workflow の各公開インターフェースは、次の安定性レベ - Python SDK: `durable-workflow/sdk-python` の `README.md`。`durable_workflow` パッケージ公開 API の規範です。 - Rust SDK: `durable-workflow/sdk-rust` の `README.md` と `[package.metadata.durable-workflow]`。`durable-workflow` crate 公開 API とパッケージ互換性宣言の規範です。 +## 組み込み PHP と Laravel のサポート {#embedded-php-and-laravel-support} + +組み込みパッケージの環境要件は、公開済みの Composer マニフェストとアップグレードマニフェストで +定義されます。ソースのマージは、公開済みサポートやインストール済み成果物の検証を意味しません。 + +| Workflow 系列 | PHP 制約 | Laravel 制約 | 根拠 | +| --- | --- | --- | --- | +| 公開済み 2.20.4 | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [公開済み 2.20.4 マニフェスト](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21、未公開 | `^8.2` | `^12.69.0\|^13.30.0` | [予定されたソース](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json)。実際の公開と Release Verification は未完了 | + +Laravel 10 は PHP 8.1 を許可し、Laravel 11/12 は PHP 8.2、Laravel 13 は PHP 8.3 を要求します。 +Composer の宣言範囲は、すべてのインタープリターとデータベースの組み合わせを検証するものではありません。 +[2.21 アップグレード案内](/docs/installation/#preparing-for-workflow-2-21)に従って環境を準備してください。 +Laravel 9 のアプリケーションは、フレームワークを更新するまで対応する 2.16.x 系列を使用します。 +過去の 1.x 契約は変わりません。 + +フレームワーク非依存の PHP SDK は、独立した PHP `^8.1` 要件を維持します。 +[Laravel サービスモードのブリッジ](https://php.durable-workflow.com/frameworks/laravel/)は、SDK 自身の +公開済み契約に従います。予定された Workflow の変更によって、このブリッジのサポートを先に +縮小したり、独立した Server、Python、Rust の要件を変えたりすることはありません。 +この環境要件の変更は、Worker プロトコルや永続履歴のバージョンを変更しません。 + ## リリースルール {#release-rules} 以下は上記の全公開分類に適用します。JSON ミラーの `release_rules` にも記載しています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/installation.md b/i18n/ja/docusaurus-plugin-content-docs/current/installation.md index db543dda877..eae0ffbe21d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/installation.md @@ -12,8 +12,36 @@ sidebar_position: 3 ## 必要な環境 {#requirements} -- PHP 8.1 以降 -- Laravel 9 以降 +公開済みの Workflow 2.20.x 系列には、次が必要です。 + +- PHP `^8.1` +- [パッケージマニフェスト](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + に記載された最低バージョンを満たす Laravel 10–13 + +Laravel 11 と 12 には PHP 8.2 以降、Laravel 13 には PHP 8.3 以降が必要です。 +正確な制約と PHP SDK の独立した要件は +[バージョン互換性](/docs/compatibility/#embedded-php-and-laravel-support)を参照してください。 + +### Workflow 2.21 への準備 {#preparing-for-workflow-2-21} + +:::info 未公開のサポート変更 + +Workflow 2.21 のソースは PHP `^8.2` と Laravel `^12.69.0|^13.30.0` を要求します。 +まだ公開されておらず、Release Verification も完了していません。下記のインストールコマンドは +引き続き公開済みの成果物を選択します。ソースの統合だけでは、その根拠は変わりません。 + +::: + +2.21 を導入する前に、PHP 8.1 または Laravel 10/11 のアプリケーションを対応プラットフォームへ +更新してください。Laravel 13 には引き続き PHP 8.3 以降が必要です。準備とテストの間は既存の +2.20.x のロックファイルを保持し、Web、CLI、Worker の各プロセスの環境を更新します。 +2.21 を明示的に指定した場合、非対応の環境は拒否される必要があります。Composer の +プラットフォーム検査とセキュリティ勧告によるブロックを有効にしてください。 +2.20.x を維持しても、古い PHP や Laravel の上流のセキュリティサポートは延長されません。 + +このサポート変更自体は、スキーマ、履歴、プロトコルの移行を導入しません。 +既存の v1 実行は v1 が引き続き管理します。排出または共存には、引き続き +[移行手順](/docs/migration/)を適用してください。 組み込みと Server の宣言、正確なテスト構成、検証の限界は[データベースの互換性](./polyglot/database-support.md)を確認してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md index 9a015ce7d88..adfdbaf09d7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -34,7 +34,12 @@ Laravel アプリケーションには、Durable Workflow 2.0 のファースト | 安定版 v1 Laravel | PHP SDK サービスモード | Laravel の依存注入、設定、Artisan、ログ、イベント、テスト fake を維持し、永続状態は Cloud・Server が所有する。 | `durable-workflow/sdk` を別のサービスクライアント・Worker 境界として追加。v1 履歴と永続 Laravel キュージョブは終端まで v1 に残す。 | | 2.0 組み込み Laravel | PHP SDK サービスモード | アプリによるオーケストレーションランタイム所有をやめる、または共有・多言語ランタイムが必要。 | Worker 準備後、新規開始をサービスへ振り向ける。組み込み実行は開始元でドレインするか、セルフホスト Server 向けの適格な組み込み v2 の明示的インポートを使う。 | -PHP SDK ブリッジと組み込みパッケージは、互換 PHP バージョン上の Laravel 9～13 をサポートします。サポート対象 v1 アプリは、無関係な Laravel 更新なしでどちらも選べます。 +移行先を選ぶ前に、それぞれの環境要件を確認してください。 +[組み込みインストールガイド](/docs/installation/#requirements)は、公開済み 2.20.x の要件と、 +未公開の 2.21 へのアップグレード境界を説明します。 +[PHP SDK の Laravel ガイド](https://php.durable-workflow.com/frameworks/laravel/)は、別個のサービスブリッジ契約を +定義します。SDK 単体の PHP `^8.1` 要件は、すべてのフレームワーク構成を保証しません。 +対応している v1 環境でも、選んだ移行先へ進む前に PHP や Laravel の更新が必要になることがあります。 ## 所有境界を比較する {#compare-the-ownership-boundary} @@ -294,7 +299,8 @@ WorkflowStub::assertDispatched( composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9～13 は provider を自動検出します。設定を公開し、属性付きハンドラークラスを列挙します。 +対応する Laravel リリースでは SDK のプロバイダーが自動検出されます。 +パッケージ設定を公開し、属性付きのハンドラークラスを登録してください。 ```php diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/migration.md b/i18n/ja/docusaurus-plugin-content-docs/current/migration.md index bb18139e23d..b848d1df7e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/migration.md @@ -17,6 +17,22 @@ keywords: このガイドは、既存 Laravel v1 アプリケーションを v2 へ更新する際の主な変更を扱います。まず [Laravel への導入とランタイム移行ガイド](/docs/laravel-adoption/)で、Laravel がランタイムを所有し続けるか、PHP SDK 経由で Cloud・セルフホスト Server に接続するかを選んでください。その後、このページの詳細な v1 から v2 への組み込みパッケージ手順を使います。 +## 移行先の環境を確認する {#check-the-target-platform} + +Composer の制約を変更する前に、公開済みの移行先パッケージの +[PHP と Laravel の要件](/docs/installation/#requirements)を確認してください。 +安定版 v1 で対応している環境が、そのまま現在の組み込み v2 に対応するとは限りません。 +特に Laravel 9 のアプリケーションは、公開済み 2.20.x 系列を導入する前にフレームワークを更新する必要があります。 + +[2.21 の準備案内](/docs/installation/#preparing-for-workflow-2-21)では、PHP 8.1 と Laravel 10/11 の +サポート終了予定を説明します。この系列はまだ公開されておらず、Release Verification も未完了です。 +環境の更新を準備する間は、既存の 2.20.x ロックファイルを保持してください。 +以前のリリースを使い続けても、上流のセキュリティサポートは延長されません。 +SDK 単体と Laravel ブリッジには、それぞれ独自の公開済み要件があります。 + +この変更自体は、スキーマ、履歴、プロトコルの移行を導入しません。v1 の履歴は v1 が管理し続けます。 +以下の排出、共存、ロールバックのルールは引き続き必要です。Composer の変更で実行が移行されることはありません。 + ## アップグレード手順 {#upgrade-procedure} ### アップグレード前 {#before-upgrading} diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/ja/source-hashes.json +++ b/i18n/ja/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91", diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md index b56df05c2c1..6ba90f149af 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/compatibility.md @@ -136,6 +136,31 @@ Estes documentos acrescentam detalhes de cada pacote sob as regras desta página `durable-workflow/sdk-rust`. Normativos para a API pública da crate `durable-workflow` e sua declaração de compatibilidade de pacote. +## Suporte a PHP e Laravel no modo integrado {#embedded-php-and-laravel-support} + +Os requisitos de plataforma do pacote integrado vêm dos manifestos publicados +de Composer e atualização. Integrar código-fonte não comprova suporte publicado +nem a qualificação de uma instalação. + +| Linha Workflow | Restrição PHP | Restrição Laravel | Autoridade | +| --- | --- | --- | --- | +| 2.20.4 publicada | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [Manifesto publicado 2.20.4](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21, não publicada | `^8.2` | `^12.69.0\|^13.30.0` | [Código previsto](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json); publicação real e Release Verification ainda necessárias | + +Laravel 10 permite PHP 8.1, Laravel 11/12 exigem PHP 8.2 e Laravel 13 exige +PHP 8.3. Uma faixa declarada no Composer não qualifica todas as combinações de +interpretador e banco de dados. Prepare a plataforma com o +[guia de atualização para 2.21](/docs/installation/#preparing-for-workflow-2-21). +Aplicações Laravel 9 permanecem na linha compatível 2.16.x até atualizar o +framework. O contrato histórico 1.x permanece inalterado. + +O SDK PHP independente de framework mantém seu próprio requisito PHP `^8.1`. +Sua [ponte Laravel em modo de serviço](https://php.durable-workflow.com/frameworks/laravel/) +segue o contrato publicado do SDK. A mudança planejada de Workflow não reduz +antecipadamente esse suporte nem altera os requisitos do Server independente, +Python ou Rust. Esse limite de plataforma não altera versões do protocolo de +workers nem do histórico durável. + ## Regras de release {#release-rules} Estas regras valem para todas as famílias públicas acima. São reproduzidas diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md index ef5f3b4b138..51f7ee603b7 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/installation.md @@ -20,8 +20,38 @@ trata do Laravel integrado. ## Requisitos {#requirements} -- PHP 8.1 ou superior -- Laravel 9 ou superior +A linha publicada Workflow 2.20.x exige: + +- PHP `^8.1` +- Laravel 10–13 nas versões mínimas declaradas no + [manifesto do pacote](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + +Laravel 11 e 12 exigem PHP 8.2 ou superior; Laravel 13 exige PHP 8.3 ou superior. +Veja [Compatibilidade de versões](/docs/compatibility/#embedded-php-and-laravel-support) +para as restrições exatas e o limite independente do SDK PHP. + +### Preparação para Workflow 2.21 {#preparing-for-workflow-2-21} + +:::info Mudança de suporte ainda não publicada + +O código de Workflow 2.21 exige PHP `^8.2` e Laravel `^12.69.0|^13.30.0`. +Ainda não foi publicado nem passou por Release Verification. O comando abaixo +continua selecionando um artefato publicado; integrar o código-fonte não muda +essa autoridade. + +::: + +Atualize aplicações PHP 8.1 ou Laravel 10/11 para uma plataforma suportada antes +de adotar 2.21. Laravel 13 continua exigindo PHP 8.3 ou superior. Atualize os +processos web, CLI e workers, mantendo o arquivo de lock 2.20.x da aplicação +durante a preparação e os testes. Uma solicitação explícita de 2.21 deve recusar +uma plataforma não suportada; mantenha ativas as verificações de plataforma e +o bloqueio por avisos de segurança do Composer. Manter 2.20.x não estende o +suporte de segurança dos projetos PHP ou Laravel. + +Essa mudança de suporte não introduz migração de esquema, histórico ou +protocolo. As execuções v1 continuam pertencendo à v1; o +[procedimento de migração](/docs/migration/) continua definindo o esvaziamento ou a coexistência. Confira [Compatibilidade de bancos de dados](./polyglot/database-support.md) para declarações do modo embutido e Server, configurações exatas testadas e limites de qualificação. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md index c598977bdf3..050d9330156 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -41,9 +41,13 @@ depois de escolher a política de transição aqui. | Laravel v1 estável | SDK PHP em modo de serviço | O Laravel deve manter injeção de dependências, configuração, Artisan, logs, eventos e fakes de teste, mas o Cloud ou Server deve ser responsável pelo estado durável. | Instale `durable-workflow/sdk` como uma fronteira separada de cliente/worker de serviço. O histórico v1 e os jobs duráveis das filas Laravel permanecem no runtime v1 até atingirem estado terminal. | | Laravel 2.0 integrado | SDK PHP em modo de serviço | A aplicação deve deixar de ser responsável pelo runtime de orquestração ou precisa de uma fronteira de runtime compartilhada/entre linguagens. | Direcione novos inícios ao runtime de serviço depois que seus workers estiverem prontos. Deixe as execuções integradas terminarem onde começaram, ou use o procedimento explícito de importação de execuções elegíveis da v2 integrada para Server sob sua administração. | -A ponte Laravel do SDK PHP e o pacote integrado suportam Laravel 9 a 13 nas -versões compatíveis de PHP. Assim, uma aplicação v1 suportada pode escolher -qualquer um dos destinos sem uma atualização não relacionada do Laravel. +Verifique os requisitos de cada destino antes de escolhê-lo. O +[guia de instalação integrada](/docs/installation/#requirements) descreve os +requisitos publicados de 2.20.x e o limite de atualização de 2.21 ainda não +publicada. O [guia Laravel do SDK PHP](https://php.durable-workflow.com/frameworks/laravel/) +é a autoridade independente da ponte de serviço; o mínimo PHP `^8.1` do SDK +básico não comprova todas as combinações de framework. Mesmo um host v1 +suportado pode precisar atualizar PHP ou Laravel antes de mudar de destino. ## Compare a fronteira de responsabilidade {#compare-the-ownership-boundary} @@ -331,8 +335,8 @@ copiado de uma release específica: composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -O Laravel 9 a 13 descobre o provider automaticamente. Publique a configuração -do pacote e liste as classes de handlers com atributos: +As versões suportadas de Laravel descobrem automaticamente o provider do SDK. +Publique a configuração do pacote e liste as classes de handlers com atributos: ```php diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/migration.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/migration.md index 0972a5bd714..2472fda0cad 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/migration.md @@ -21,6 +21,25 @@ conectará ao Cloud ou a um Server sob sua administração pelo SDK PHP no [guia de adoção no Laravel e transição de runtime](/docs/laravel-adoption/). Esta página apresenta então o procedimento detalhado do pacote integrado da v1 para v2. +## Verifique a plataforma de destino {#check-the-target-platform} + +Antes de alterar as restrições do Composer, confira os +[requisitos de PHP e Laravel](/docs/installation/#requirements) do pacote +publicado de destino. O suporte estável v1 não implica suporte ao mesmo host +na v2 integrada atual. Em particular, aplicações Laravel 9 precisam atualizar +o framework antes de adotar a linha publicada 2.20.x. + +A [preparação de 2.21](/docs/installation/#preparing-for-workflow-2-21) +descreve a retirada planejada do suporte a PHP 8.1 e Laravel 10/11. Essa linha +ainda não foi publicada nem passou por Release Verification. Mantenha o arquivo +de lock 2.20.x enquanto prepara a plataforma; versões anteriores não estendem +o suporte de segurança dos projetos de origem. O SDK PHP básico e sua ponte +Laravel têm seus próprios requisitos publicados. + +Essa mudança não introduz migração de esquema, histórico ou protocolo. A v1 +continua sendo dona do histórico v1. As regras de esvaziamento, coexistência e +rollback abaixo permanecem necessárias; alterar o Composer nunca migra uma execução. + ## Procedimento de atualização {#upgrade-procedure} ### Antes de atualizar {#before-upgrading} diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/pt-BR/source-hashes.json +++ b/i18n/pt-BR/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md index 441cf5de288..192ac5d636f 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/compatibility.md @@ -132,6 +132,30 @@ OpenAPI, AsyncAPI чи JSON Schema. Schema - Python SDK — `README.md` у `durable-workflow/sdk-python`. Джерело контракту публічного API пакета `durable_workflow`. - Rust SDK — `README.md` і `[package.metadata.durable-workflow]` у `durable-workflow/sdk-rust`. Джерело контракту публічного API crate `durable-workflow` та його оголошення сумісності. +## Підтримка PHP і Laravel у вбудованому режимі {#embedded-php-and-laravel-support} + +Вимоги вбудованого пакета до платформи визначають його опубліковані маніфести +Composer та оновлення. Інтеграція коду не підтверджує опубліковану підтримку +або кваліфікацію встановленого пакета. + +| Лінійка Workflow | Обмеження PHP | Обмеження Laravel | Джерело повноважень | +| --- | --- | --- | --- | +| Опублікована 2.20.4 | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [Опублікований маніфест 2.20.4](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21, не опублікована | `^8.2` | `^12.69.0\|^13.30.0` | [Запланований вихідний код](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json); потрібні фактична публікація та Release Verification | + +Laravel 10 допускає PHP 8.1, Laravel 11/12 потребують PHP 8.2, а Laravel 13 — +PHP 8.3. Задекларований діапазон Composer не підтверджує кожне поєднання +інтерпретатора та бази даних. Підготуйте платформу за +[настановою з оновлення до 2.21](/docs/installation/#preparing-for-workflow-2-21). +Застосунки Laravel 9 залишаються на сумісній лінійці 2.16.x до оновлення +фреймворку. Історичний контракт 1.x не змінюється. + +Незалежний від фреймворку PHP SDK зберігає власну вимогу PHP `^8.1`. +Його [Laravel bridge у service mode](https://php.durable-workflow.com/frameworks/laravel/) +має окремий опублікований контракт. Запланована зміна Workflow не звужує +підтримку bridge завчасно й не змінює вимог окремого Server, Python або Rust. +Ця межа платформи не змінює версій worker protocol чи довготривалої історії. + ## Правила випусків {#release-rules} Ці правила діють для кожного сімейства публічних поверхонь вище. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/installation.md b/i18n/uk/docusaurus-plugin-content-docs/current/installation.md index 61f13996a3a..ef2a9d9d023 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/installation.md @@ -20,8 +20,38 @@ sidebar_position: 3 ## Вимоги {#requirements} -- PHP 8.1 або новіший -- Laravel 9 або новіший +Опублікована лінійка Workflow 2.20.x потребує: + +- PHP `^8.1` +- Laravel 10–13 із мінімальними версіями, задекларованими в + [маніфесті пакета](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + +Laravel 11 і 12 потребують PHP 8.2 або новішої версії; Laravel 13 — PHP 8.3 або +новішої. Точні обмеження та окрему межу PHP SDK дивіться в +[сумісності версій](/docs/compatibility/#embedded-php-and-laravel-support). + +### Підготовка до Workflow 2.21 {#preparing-for-workflow-2-21} + +:::info Ще не опублікована зміна підтримки + +Вихідний код Workflow 2.21 потребує PHP `^8.2` та Laravel `^12.69.0|^13.30.0`. +Ця версія ще не опублікована й не пройшла Release Verification. Команда нижче +й надалі вибирає опублікований артефакт; інтеграція вихідного коду не змінює +це джерело повноважень. + +::: + +Перш ніж переходити на 2.21, оновіть застосунки з PHP 8.1 або Laravel 10/11 до +підтримуваної платформи. Laravel 13 і надалі потребує щонайменше PHP 8.3. +Оновіть вебпроцеси, CLI та workers, зберігаючи наявний lock-файл застосунку +2.20.x під час підготовки й тестування. Явна вимога 2.21 має відхиляти +непідтримувану платформу; залиште ввімкненими перевірки платформи та блокування +за повідомленнями безпеки Composer. Збереження 2.20.x не продовжує підтримку +безпеки старих версій PHP або Laravel їхніми розробниками. + +Ця зміна підтримки не запроваджує міграції схеми, історії чи протоколу. +Наявні запуски v1 залишаються під керуванням v1; +[процедура міграції](/docs/migration/) і надалі визначає drain або співіснування. Дивіться [сумісність баз даних](./polyglot/database-support.md): заяви вбудованого режиму та Server, точні перевірені конфігурації й межі кваліфікації. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md index 72cdb853701..b92ee0b9390 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -41,9 +41,13 @@ Laravel-застосунки мають два офіційні режими Dur | Стабільний Laravel v1 | PHP SDK service mode | Laravel має зберігати dependency injection, конфігурацію, Artisan, логування, events і test fakes, а Cloud чи Server — відповідати за durable-стан. | Установіть `durable-workflow/sdk` як окрему межу service client/worker. Історія v1 та durable Laravel queue jobs залишаються на runtime v1 до термінального стану. | | Laravel embedded 2.0 | PHP SDK service mode | Застосунок має передати orchestration runtime або потребує спільної/polyglot межі runtime. | Спрямовуйте нові запуски до service runtime після готовності його workers. Завершіть embedded runs там, де вони почалися, або використайте явний import допустимих embedded-v2 runs для власного Server. | -PHP SDK bridge та embedded-пакет підтримують Laravel 9–13 -на сумісних версіях PHP. Тому підтримуваний застосунок v1 може -вибрати будь-який кінцевий режим без окремого оновлення Laravel. +Перед вибором перевірте вимоги кожного кінцевого режиму до платформи. +[Настанова зі встановлення embedded](/docs/installation/#requirements) +охоплює опубліковані вимоги 2.20.x та межу оновлення ще не опублікованої 2.21. +[Laravel-настанова PHP SDK](https://php.durable-workflow.com/frameworks/laravel/) +визначає окремий контракт service bridge; мінімум PHP `^8.1` самого SDK не +підтверджує кожне поєднання фреймворку. Навіть підтримуваному хосту v1 може +знадобитися оновлення PHP або Laravel перед переходом до вибраного режиму. ## Порівняння відповідальності {#compare-the-ownership-boundary} @@ -335,7 +339,7 @@ WorkflowStub::assertDispatched( composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9–13 автоматично знаходять provider. +Підтримувані версії Laravel автоматично знаходять provider SDK. Опублікуйте конфігурацію пакета та перелічіть класи обробників з атрибутами: diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/migration.md b/i18n/uk/docusaurus-plugin-content-docs/current/migration.md index d6adaf8de2a..86827b01ce3 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/migration.md @@ -21,6 +21,25 @@ keywords: [посібника з упровадження в Laravel і переходу між runtime](/docs/laravel-adoption/). Далі ця сторінка описує докладну процедуру переходу вбудованого пакета з v1 до v2. +## Перевірте цільову платформу {#check-the-target-platform} + +Перед зміною обмежень Composer перевірте +[вимоги PHP і Laravel](/docs/installation/#requirements) опублікованого +цільового пакета. Підтримка стабільної v1 не означає підтримку того самого +хоста поточною embedded v2. Зокрема, застосунки Laravel 9 мають оновити +фреймворк перед переходом на опубліковану лінійку 2.20.x. + +[Підготовка до 2.21](/docs/installation/#preparing-for-workflow-2-21) +описує заплановане припинення підтримки PHP 8.1 та Laravel 10/11. Ця лінійка ще +не опублікована й не пройшла Release Verification. Збережіть наявний lock-файл +2.20.x під час підготовки платформи; старі випуски не продовжують підтримку +безпеки вихідних проєктів. Сам PHP SDK та його Laravel bridge мають власні +опубліковані вимоги. + +Ця зміна платформи не запроваджує міграції схеми, історії чи протоколу. +Історія v1 залишається під керуванням v1. Наведені нижче правила drain, +співіснування та rollback залишаються чинними; зміна Composer ніколи не мігрує запуск. + ## Процедура оновлення {#upgrade-procedure} ### Перед оновленням {#before-upgrading} diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/uk/source-hashes.json +++ b/i18n/uk/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91", diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md index db25d250cec..913a54d9d4c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/compatibility.md @@ -96,6 +96,27 @@ Durable Workflow 中每个公开接口恰好具有以下一个稳定性级别。 - Python SDK：`durable-workflow/sdk-python` 中的 `README.md`。`durable_workflow` 软件包公开 API 的权威来源。 - Rust SDK：`durable-workflow/sdk-rust` 中的 `README.md` 和 `[package.metadata.durable-workflow]`。`durable-workflow` crate 公开 API 及软件包兼容性声明的权威来源。 +## 嵌入式 PHP 与 Laravel 支持范围 {#embedded-php-and-laravel-support} + +嵌入式软件包的平台要求以其已发布的 Composer 和升级清单为准。 +源代码合并并不代表已经发布支持，也不代表已通过安装产物验证。 + +| Workflow 系列 | PHP 约束 | Laravel 约束 | 权威依据 | +| --- | --- | --- | --- | +| 已发布的 2.20.4 | `^8.1` | `^10.50.4\|^11.56.1\|^12.69.0\|^13.30.0` | [已发布的 2.20.4 清单](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) | +| 2.21，尚未发布 | `^8.2` | `^12.69.0\|^13.30.0` | [计划中的源代码](https://github.com/durable-workflow/workflow/blob/3d7d0a193d8fffe591f8286d1c4d5499120a297a/resources/laravel-embedded-upgrade-contract.json)；仍须实际发布并通过 Release Verification | + +Laravel 10 允许使用 PHP 8.1，Laravel 11/12 要求 PHP 8.2，Laravel 13 要求 PHP 8.3。 +声明的 Composer 范围并不验证所有解释器与数据库组合。请按照 +[2.21 升级指引](/docs/installation/#preparing-for-workflow-2-21)准备平台。 +Laravel 9 应用在升级框架之前，应继续使用其兼容的 2.16.x 系列。 +历史 1.x 契约保持不变。 + +不依赖框架的 PHP SDK 仍保留独立的 PHP `^8.1` 要求。 +其 [Laravel 服务模式桥接](https://php.durable-workflow.com/frameworks/laravel/)遵循 SDK 自己的已发布契约。 +Workflow 计划中的平台变更不会提前缩小该桥接的支持范围，也不会改变独立 Server、Python 或 Rust 的要求。 +这一平台支持边界不会改变 Worker 协议或持久历史的版本。 + ## 发布规则 {#release-rules} 这些规则适用于上述每个公开接口族，也在 JSON 镜像的 `release_rules` 下提供。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md index 5f6b1a6fded..dcccaf6f2a5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/installation.md @@ -12,8 +12,34 @@ sidebar_position: 3 ## 环境要求 {#requirements} -- PHP 8.1 或更高版本 -- Laravel 9 或更高版本 +已发布的 Workflow 2.20.x 系列要求： + +- PHP `^8.1` +- Laravel 10–13，且满足[软件包清单](https://github.com/durable-workflow/workflow/blob/2.20.4/composer.json) + 中声明的最低版本 + +Laravel 11 和 12 要求 PHP 8.2 或更高版本，Laravel 13 要求 PHP 8.3 或更高版本。 +确切约束及 PHP SDK 的独立边界请参阅 +[版本兼容性](/docs/compatibility/#embedded-php-and-laravel-support)。 + +### 为 Workflow 2.21 做准备 {#preparing-for-workflow-2-21} + +:::info 尚未发布的支持范围变更 + +Workflow 2.21 的源代码要求 PHP `^8.2` 和 Laravel `^12.69.0|^13.30.0`。 +该版本尚未发布，也尚未通过 Release Verification。下方安装命令仍选择已发布的产物； +合并源代码不会改变这一权威依据。 + +::: + +采用 2.21 之前，请将使用 PHP 8.1 或 Laravel 10/11 的应用升级到受支持的平台。 +Laravel 13 仍要求 PHP 8.3 或更高版本。准备和测试期间应保留应用现有的 2.20.x 锁文件， +并更新 Web、CLI 和 Worker 进程所用的环境。显式要求 2.21 时应拒绝不受支持的平台； +请保持 Composer 的平台检查和安全公告阻断机制启用。保留 2.20.x 并不会延长旧版 +PHP 或 Laravel 的上游安全支持。 + +此次支持范围变更不引入模式、历史或协议迁移。现有 v1 运行仍由 v1 管理； +排空或共存仍须遵循[迁移流程](/docs/migration/)。 参阅[数据库兼容性](./polyglot/database-support.md)，了解嵌入式与 Server 声明、确切测试配置及验证边界。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md index 6fdf957e3bd..d20e5954f50 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/laravel-adoption.md @@ -34,7 +34,11 @@ Laravel 应用有两个第一方 Durable Workflow 2.0 目标。嵌入模式让 | 稳定 v1 Laravel | PHP SDK 服务模式 | Laravel 应保留依赖注入、配置、Artisan、日志、事件和测试 fake，但由 Cloud 或 Server 拥有持久状态。 | 安装 `durable-workflow/sdk` 作为独立服务客户端/Worker 边界。v1 历史和持久 Laravel 队列 job 留在 v1 运行时，直到进入终态。 | | 2.0 嵌入式 Laravel | PHP SDK 服务模式 | 应用应不再拥有编排运行时，或需要共享/多语言运行时边界。 | 服务 Worker 就绪后，将新启动路由到服务运行时。嵌入运行实例在原处排空，或对自托管 Server 使用明确的符合条件的嵌入 v2 导入流程。 | -PHP SDK 桥接和嵌入软件包在各自兼容的 PHP 版本上支持 Laravel 9 至 13。因此，受支持的 v1 应用无需进行无关的 Laravel 升级即可选择任一目标。 +选择迁移目标之前，请分别检查其平台要求。 +[嵌入式安装指南](/docs/installation/#requirements)说明已发布的 2.20.x 要求以及尚未发布的 2.21 升级边界。 +[PHP SDK 的 Laravel 指南](https://php.durable-workflow.com/frameworks/laravel/)负责独立的服务桥接契约； +SDK 本身的 PHP `^8.1` 最低要求并不保证所有框架组合都受支持。 +即使 v1 主机受支持，迁移到所选目标之前仍可能需要升级 PHP 或 Laravel。 ## 比较归属边界 {#compare-the-ownership-boundary} @@ -294,7 +298,8 @@ WorkflowStub::assertDispatched( composer require %%artifact.publishedPhpSdkComposerPackage%% ``` -Laravel 9 至 13 自动发现 provider。发布软件包配置，并列出带属性标记的处理器类： +受支持的 Laravel 版本会自动发现 SDK 服务提供者。 +请发布软件包配置，并列出带有属性的处理器类： ```php diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/migration.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/migration.md index 53fc95c3e24..dbd1cb9cdba 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/migration.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/migration.md @@ -17,6 +17,19 @@ keywords: 本指南介绍现有 Laravel v1 应用升级至 v2 时的主要变化。首先在 [Laravel 采用与运行时迁移指南](/docs/laravel-adoption/)中选择：继续由 Laravel 拥有运行时，还是通过 PHP SDK 连接 Cloud 或自托管 Server。本页随后提供详细的 v1 到 v2 嵌入式软件包操作流程。 +## 检查目标平台 {#check-the-target-platform} + +修改 Composer 约束之前，请核对目标已发布软件包的 +[PHP 与 Laravel 要求](/docs/installation/#requirements)。稳定版 v1 支持某台主机，并不表示当前嵌入式 v2 +也支持同一环境。尤其是 Laravel 9 应用，必须先升级框架，才能采用已发布的 2.20.x 系列。 + +[2.21 准备指引](/docs/installation/#preparing-for-workflow-2-21)说明了计划移除 PHP 8.1 和 Laravel 10/11 +支持的边界。该系列尚未发布，也尚未通过 Release Verification。准备平台升级时，请保留现有的 +2.20.x 应用锁文件；旧版本不会延长上游安全支持。PHP SDK 本身及其 Laravel 桥接具有各自的已发布要求。 + +此平台变更不引入模式、历史或协议迁移。v1 历史仍由 v1 管理。下述排空、共存和回滚规则继续适用； +修改 Composer 从来不会迁移运行实例。 + ## 升级流程 {#upgrade-procedure} ### 升级之前 {#before-upgrading} diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index 8f4abd62c77..c159ee9b209 100644 --- a/i18n/zh-Hans/source-hashes.json +++ b/i18n/zh-Hans/source-hashes.json @@ -4,7 +4,7 @@ "ai-agent-workflow-engine.md": "28016466b179adbabdff6467ce351100c9bee48529a8bec9df7ec22c8d786d4d", "ai-assisted-development.md": "b246bb60585fb7a69bc534978f470f3f16e899e1f8f203ba0847d2d11b8a1ec3", "capabilities.md": "d9a2bbc0d04adf8cb3f4c7f42d779a43aafab60791210305e7e476c0499528fc", - "compatibility.md": "7920228a2941f3f335b224580170c1ae74382dd86d0d454bfbdbb6c703fe1eb6", + "compatibility.md": "4f17a4c826c2b83abe21d860195f22f9b87b50f7b2200962f6840949ba3c967a", "configuration/customization-matrix.md": "3d115863eaee7852b541bcd01615f424cc19c5847c7cd7d75e5ae63bc3f5cc78", "configuration/database-connection.md": "cc83ae77133236309506fa44d39bfd0c939c32a6154c0bd6099bc64c83bdaec9", "configuration/ensuring-same-server.md": "6c665f37cc198c7b1a775a60a94aab5ff4e55383385e76f1834c7840559b512a", @@ -58,11 +58,11 @@ "features/webhooks.md": "edcdfc05ccb0d34a77c51594f85bc3cab343e787f8e0e08d2cd4ddebd048e8c8", "features/worker-sessions.md": "5065368fb5b93599dbd08d97cb9ac312576eb42fee14f081db663aa9f78fb68c", "how-it-works.md": "90454c37f4244297d5c11bcc59549859acf59f88d15ecd26f0a6951c115f86eb", - "installation.md": "982bf4d47460c440ae11991e0db42ba43bf7e7aff82120c4e351cfc5023ad931", + "installation.md": "1fd4db96f0058f2fccefbfd4d424b326d322f29e760b3b066515b9e5f82c5149", "introduction.md": "06bf96d164d402d4e376c6308b20f96d324110b2e0cf96c2a1a67b39906072e3", - "laravel-adoption.md": "f7fe728d0226a5c9b7de4ff6dd130ea1f1003715eb30888983e49fa66cc6e7b8", + "laravel-adoption.md": "0e84896c2340f0bfe89e36c7fc75711c6434df4fd57ec85ed49121749bf4b767", "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e", - "migration.md": "7304a53786d5e45d3a639c33386e6558e855ee77982883a5e051ef5084b8453b", + "migration.md": "98724032db902d177e95889712a64f1f92ad8f2a0eafa5db9253f21c61307ebe", "monitoring.md": "202278c1196508df5ff00d34cfe94fd2d60dfb7fd2fcb768cf37864c7605de0a", "operator-operating-envelope.md": "dc0cf13d8593e4ce2d8ec1912e45e61c9bf13f06abf7cc8c422379db5e3fa0ad", "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91",