
如果你使用 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%E9%A1%B5%E9%9D%A2%E3%80%82
要使用这些镜像,您可以从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本项目包含以下变体:
每个变体支持5.6至8.4的多个PHP版本,并提供amd64和arm64架构版本。
有用链接
镜像默认以php用户(uid 1000)运行。如需以root用户运行命令,可在启动容器时使用--user标志。
若需向挂载卷写入文件,请确保php用户具有必要权限。可通过以下命令将挂载目录所有权设置为php用户:
shchown -R 1000:1000 /path/to/your/directory
另一种解决方法是在启动容器前将挂载目录权限设为777,允许所有用户读写执行该目录中的文件。但出于安全考虑,不建议在生产环境中使用此方法。
还可通过--user标志以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许可,可用于个人和商业项目。但请注意,镜像按"原样"提供,不提供任何形式的担保或保证。使用风险自负。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。



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