Sail Plugins

[elnurvl]

This PR adds a plugin system to Laravel Sail, allowing third-party packages to customize the Docker environment without expanding the core package.

Currently, Sail requires direct updates to its codebase to accommodate new services or runtime variations, which increases maintenance overhead as community demands grow.

With this plugin system, external packages can define new services, override built-in ones like mysql or redis, or introduce additional logic. This offloads the upkeep of non-essential or specialized services to third-party packages, keeping Sail’s core streamlined and reducing the frequency of updates needed in the base package. For instance, niche use cases—such as configuring an nginx web server with HTTPS or integrating authorization servers, such as Keycloak can be managed externally, avoiding unnecessary growth in Sail’s scope.

End developers may include these plugins on-demand within their applications, opting in only to the customizations they need. The core package stays focused on providing a reliable, minimal Docker setup.

See the linked documentation PR for implementation details, examples, and guidance.

[github-actions]

Thanks for submitting a PR!

In order to review and merge PRs most efficiently, we require that all PRs grant maintainer edit access before we review them. For information on how to do this, see the relevant GitHub documentation. Additionally, GitHub doesn't allow maintainer permissions from organization accounts. Please resubmit this PR from a personal GitHub account with maintainer permissions enabled.