Laravel专用PHP-FPM Docker镜像

专为运行基于Laravel的应用程序打造的PHP-FPM容器Docker镜像。

规格说明：

• PHP版本支持：8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 5.6 / 5.4
• 包含PHP扩展：OpenSSL、PDO、SOAP、Mbstring、Tokenizer、XML、PCNTL、ZIP、GD、BCMath、GMP、Intl、Imagick
• 集成工具：Memcached、Composer
• Laravel定时任务：支持任务调度设置的Cron Job
• Laravel优化配置：预配置Laravel专用PHP ini值（详见laravel.ini）
• xDebug支持：兼容PHPStorm（详见xdebug.ini）
• 便捷别名：
  • t：运行单元测试（vendor/bin/phpunit），使用docker-compose exec [service_name] t
  • d：运行Laravel Dusk浏览器测试（artisan dusk），使用docker-compose exec [service_name] d
  • art：运行Laravel artisan命令
  • fresh：执行数据库迁移刷新并填充种子数据（artisan migrate:fresh --seed）

可用标签：

在docker-compose.yml文件中使用镜像时，可指定镜像标签。标签用于区分不同版本的Docker镜像。

• 8.4
• 8.3
• 8.2
• 8.1
• 8.0
• 7.4
• 7.3
• 7.2
• 7.1
• 7.0
• 5.6
• 5.4

注意：master分支不用于生成镜像，仅用于文档。仅标签/分支用于生成镜像。

docker-compose使用方法：

yml
version: '2'
services:
    php-fpm:
        image: cyberduck/php-fpm-laravel(:<version-tag>)
        volumes:
            - ./:/var/www/
            - ~/.ssh:/root/.ssh # 可用于composer（如果你使用私有代码仓库）
        networks:
            - my_net # 如果你在容器之间使用网络

Xdebug使用方法：

所有PHP 8.1以上版本的镜像均配置支持xDebug 3。

镜像预装Xdebug但默认禁用。可通过环境变量启用Xdebug，可通过.env文件、docker命令或docker-compose传递环境变量实现。

使用.env文件

在.env文件中添加以下内容，然后启动/重启容器：

text
XDEBUG=true
PHP_IDE_CONFIG="serverName=phpstorm-server" # 仅PhpStorm需要，用于路径映射
REMOTE_HOST="<HOST_IP>" # 若未设置，默认值为'host.docker.internal'，适用于OSX和Windows

使用docker命令

通过-e选项在run命令中传递所需变量：

bash
docker run -d \
    -e XDEBUG=true \
    -e PHP_IDE_CONFIG="serverName=phpstorm-server" \ # 仅PhpStorm需要，用于路径映射
    -e REMOTE_HOST="<HOSTIP>" \ # 若未设置，默认值为'host.docker.internal'，适用于OSX和Windows
    -v /root/of/project:/var/www \ 
    -v ~/.ssh:/root/.ssh \
    cyberduck/php-fpm-laravel(:<version-tag>)

使用docker-compose

在使用该镜像的服务的environment部分传递变量：

yml
version: '2'
services:
    php-fpm:
        image: cyberduck/php-fpm-laravel(:<version-tag>)
        environment:
            XDEBUG: true
            PHP_IDE_CONFIG: "serverName=phpstorm-server" # 仅PhpStorm需要，用于路径映射
            REMOTE_HOST: "<HOSTIP>" # 若未设置，默认值为'host.docker.internal'，适用于OSX和Windows
        volumes:
            - ./:/var/www/
            - ~/.ssh:/root/.ssh # 可用于composer（如果你使用私有代码仓库）
        networks:
            - my_net # 如果你在容器之间使用网络

PhpStorm配置

要使xDebug与PhpStorm配合使用，需创建服务器。通过Preferences > Languages & Frameworks > PHP > Servers进入，然后按以下步骤操作：

1. 点击+符号。
2. 为服务器命名，该名称将作为PHP_IDE_CONFIG变量中的serverName值，例如PHP_IDE_CONFIG="serverName=<CONFIGURED_SERVER_NAME>"。
3. 设置Host为http://localhost，若使用虚拟主机则使用对应主机名，例如http://myapp.localhost。
4. 设置端口为宿主机使用的端口，例如80。
5. 设置调试器为Xdebug。
6. 勾选Use path mappings复选框。
7. 在项目文件部分找到项目根目录，右侧填写其在容器内的路径，例如/var/www。
8. 点击应用并关闭偏好设置。
9. 通过Run > Start listening for PHP debug connections开始监听传入连接。
10. 现在可通过添加断点或选择Run > Break at first line in PHP scripts并刷新浏览器测试Xdebug。

Visual Studio Code配置

要在Visual Studio Code中使用Xdebug，需在项目根目录的.vscode文件夹中添加launch.json文件。以下是launch.json文件示例：

json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www": "${workspaceFolder}"
            }
        }
    ]
}

添加后，导航至调试部分，在左侧BREAKPOINTS部分取消勾选Everything复选框。从顶部下拉菜单选择Listen for XDebug，然后按播放按钮。

现在可通过添加断点并刷新浏览器测试Xdebug。