agilitycisltd/laravel-dev

Laravel-dev 镜像

镜像概述和主要用途

该镜像维护用于构建Laravel应用的不同版本和变体（fpm/cli）的PHP基础镜像。仅包含基本扩展，所有构建依赖在构建结束时被移除。适用于Laravel应用的开发环境，提供预配置的开发相关设置。

核心功能和特性

• 支持不同PHP版本和变体（fpm/cli）
• 仅包含构建Laravel应用所需的基本扩展
• 构建过程中移除所有构建依赖，减小镜像体积
• 预配置开发环境相关环境变量，包括Xdebug、Composer和OPcache设置
• 继承自webtoolsdev/laravel-base镜像

使用场景和适用范围

• Laravel应用的开发环境构建
• 需要基础PHP环境且仅包含必要扩展的开发场景
• 需要预配置Xdebug调试和Composer设置的开发环境

环境变量配置

镜像特有环境变量

PHP_XDEBUG_START_WITH_REQUEST: yes
PHP_XDEBUG_MODE: develop,debug
PHP_XDEBUG_CLIENT_HOST: host.docker.internal
PHP_XDEBUG_CLIENT_PORT: 9003
DBGP_IDEKEY: PHPSTORM
COMPOSER_ALLOW_XDEBUG: 0
COMPOSER_MEMORY_LIMIT: -1

继承自webtoolsdev/laravel-base镜像的环境变量

开发环境中PHP_OPCACHE_ENABLE已禁用

PHP_OPCACHE_ENABLE: 0
PHP_OPCACHE_VALIDATE_TIMESTAMPS: 0
PHP_OPCACHE_MAX_ACCELERATED_FILES: 10000
PHP_OPCACHE_MEMORY_CONSUMPTION: 192
PHP_OPCACHE_MAX_WASTED_PERCENTAGE: 10

# PHP 8 - 当OPCACHE未启用时，JIT不会启用
PHP_OPCACHE_JIT: tracing
PHP_OPCACHE_JIT_BUTTER_SIZE: 100M

使用方法

Docker运行示例

通过环境变量自定义配置运行容器：

bash
docker run -e PHP_XDEBUG_CLIENT_HOST=192.168.1.100 -e PHP_XDEBUG_CLIENT_PORT=9000 webtoolsdev/laravel-dev:latest

Docker Compose配置示例

yaml
version: '3'
services:
  laravel-dev:
    image: webtoolsdev/laravel-dev:latest
    environment:
      - PHP_XDEBUG_MODE=develop,debug,coverage
      - COMPOSER_MEMORY_LIMIT=512M
      - PHP_OPCACHE_VALIDATE_TIMESTAMPS=1
    volumes:
      - ./laravel-app:/app

扩展安装说明

如需为项目安装更多扩展，需确保安装相应的构建依赖，并在安装完成后移除，以保持镜像精简。