diff --git a/README.md b/README.md index 1d10e57f..14d293f7 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,7 @@ containing [PHP 8.2](https://www.php.net/releases/8.2/en.php) and most popular P * [Symfony](https://github.com/dunglas/symfony-docker) * [API Platform](https://api-platform.com/docs/distribution/) +* [Laravel](docs/laravel.md) * [Sulu](https://sulu.io/blog/running-sulu-with-frankenphp) * [WordPress](https://github.com/dunglas/frankenphp-wordpress) * [Drupal](https://github.com/dunglas/frankenphp-drupal) diff --git a/docs/laravel.md b/docs/laravel.md new file mode 100644 index 00000000..8024513f --- /dev/null +++ b/docs/laravel.md @@ -0,0 +1,35 @@ +# Laravel + +## Docker + +Serving a [Laravel](https://laravel.com) web application with FrankenPHP is as easy as mounting the project in the `/app` directory of the official Docker image. + +Run this command from the main directory of your Laravel app: + +```console +docker run -p 443:443 -v $PWD:/app dunglas/frankenphp +``` + +And enjoy! + +## Local Installation + +Alternatively, you can run your Laravel projects with FrankenPHP from your local machine: + +1. [Download the binary corresponding to your system](https://github.com/dunglas/frankenphp/releases) +2. Add the following configuration to a file named `Caddyfile` in the root directory of your Laravel project: +```Caddyfile +{ + frankenphp + order php_server before file_server +} + +# The domain name of your server +localhost { + # Enable compression (optional) + encode zstd gzip + # Execute PHP files in the current directory and serve assets + php_server +} +``` +3. Start FrankenPHP from the root directory of your Laravel project: `./frankenphp run`