
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Braz PHP Docker 项目提供一套针对各种PHP环境和用例的Docker镜像。通过提供针对不同框架和工具(如Vanilla PHP、Composer、Symfony、WP-CLI和Phalcon)的预配置镜像,简化了PHP开发环境的搭建过程。这些镜像支持多种PHP版本和架构,确保为开发者提供兼容性和灵活性。
我们还提供了AI生成的 DeepWiki页面,包含更多技术信息。
💡 有关可用镜像的完整列表,请访问 https://github.com/fbraz3/php-system-docs 页面。
要使用这些镜像,可从Docker Hub拉取并结合PHP脚本或命令运行。以下是使用示例:
| Docker镜像 | 入口点 | 命令示例 | 构建状态 |
|---|---|---|---|
| https://hub.docker.com/r/fbraz3/php-cli | /usr/bin/php | docker run -v $pwd:/workspace --rm fbraz3/php-cli:8.4 myscript.php | https://github.com/fbraz3/php-base-docker/actions/workflows/base-images.yml/badge.svg](https://github.com/fbraz3/php-base-docker/actions/workflows/base-images.yml) |
| https://hub.docker.com/r/fbraz3/php-cli | /usr/bin/php | docker run -v $pwd:/workspace --rm fbraz3/php-cli:8.4-phalcon myscript.php | https://github.com/fbraz3/php-base-docker/actions/workflows/phalcon-images.yml/badge.svg](https://github.com/fbraz3/php-base-docker/actions/workflows/phalcon-images.yml) |
| https://hub.docker.com/r/fbraz3/php-composer | /usr/local/bin/composer | docker run -v $pwd:/workspace --rm fbraz3/php-composer:8.4 init | https://github.com/fbraz3/php-base-docker/actions/workflows/composer-images.yml/badge.svg](https://github.com/fbraz3/php-base-docker/actions/workflows/composer-images.yml) |
| https://hub.docker.com/r/fbraz3/wp-cli | /usr/local/bin/wp | docker run -v $pwd:/workspace --rm fbraz3/wp-cli:8.4 plugin install bbpress | https://github.com/fbraz3/php-base-docker/actions/workflows/wp-cli-images.yml/badge.svg](https://github.com/fbraz3/php-base-docker/actions/workflows/wp-cli-images.yml) |
| https://hub.docker.com/r/fbraz3/symfony-cli | /usr/local/bin/symfony | docker run -v $pwd:/workspace --rm fbraz3/symfony-cli:8.4 server:start | https://github.com/fbraz3/php-base-docker/actions/workflows/symfony-images.yml/badge.svg](https://github.com/fbraz3/php-base-docker/actions/workflows/symfony-images.yml) |
每个镜像都使用PHP版本进行标记。例如:
fbraz3/php-cli:8.4 对应PHP 8.4fbraz3/php-cli:8.4-phalcon 对应带Phalcon扩展的PHP 8.4fbraz3/php-composer:8.4 对应带Composer的PHP 8.4fbraz3/symfony-cli:8.4 对应带Symfony CLI的PHP 8.4fbraz3/wp-cli:8.4 对应带WP-CLI的PHP 8.4本项目包含以下镜像类型:
每种类型支持多个PHP版本(从5.6到8.4),并适用于amd64和arm64架构。
有用链接
镜像默认以php用户(uid 1000)运行。如需以root用户运行命令,可在启动容器时使用--user标志。
若需向挂载卷写入数据,确保php用户拥有必要权限。可通过以下命令将挂载目录的所有权设置为php用户:
shchown -R 1000:1000 /path/to/your/directory
另一种解决方法是在运行容器前将挂载目录权限设为777,允许所有用户读写执行该目录中的文件。但出于安全考虑,不建议在生产环境中使用此方法。
也可通过--user root标志以root用户运行容器,但同样不建议在生产环境中使用。
容器默认工作目录为/workspace,可通过在Dockerfile中或运行容器时设置WORKDIR环境变量进行修改。
所有镜像均预安装并配置了ssmtp用于发送邮件。默认SMTP服务器为localhost(端口25),可在PHP中使用mail()函数发送邮件。
建议将默认SMTP服务器更改为您自己的SMTP服务器。可在运行容器时设置SMTP相关环境变量,例如:
shdocker run -v $pwd:/workspace -e SMTP_MAIL_SERVER=smtp.example.com -e SMTP_AUTH_USER=username -e SMTP_AUTH_PASSWORD=password --rm fbraz3/php-cli:8.4 mail_sending.php
‼️注意:避免在命令行中设置密码,建议使用.env文件。
例如,创建包含以下内容的.env文件:
envSMTP_MAIL_SERVER=smtp.example.com SMTP_AUTH_USER=username SMTP_AUTH_PASSWORD=password
然后使用--env-file选项运行容器:
shdocker run -v $pwd:/workspace --env-file .env --rm fbraz3/php-cli:8.4 mail_sending.php
要查看所有可用于邮件发送的环境变量,请检查文件 ssmtp.sh。
也建议参考 ssmtp文档 了解更多配置信息。
欢迎贡献!随时提交issue或pull request以改进项目。
请查看 CONTRIBUTING.md 文件了解贡献指南。
有用链接
我花费大量时间和精力维护此项目。如果您觉得它有用,可考虑通过以下方式支持我:
本项目采用 Apache License 2.0 许可证,可用于个人和商业项目。但请注意,镜像按"原样"提供,不提供任何形式的担保或保证。使用风险自负。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。






来自真实用户的反馈,见证轩辕镜像的优质服务