如何用OpenShift部署Laravel?openshift/php访问异常及s2i-laravel使用咨询
部署Laravel应用的构建器选型与操作指南
你遇到Apache测试页的核心原因
你之前使用官方openshift/php构建器时,Apache默认的文档根目录指向源码的根路径,Laravel的Web访问入口是项目下的public/子目录,不是项目根路径,因此Apache找不到Laravel的入口文件,就会加载构建器镜像自带的默认测试页。
你之前测试无框架的普通PHP代码能正常运行,本质是这类代码的入口文件在项目根目录,和官方构建器的默认路径配置刚好匹配,不存在路径错位的问题。这个故障不是构建器完全不兼容Laravel,是默认路径配置和Laravel的目录结构不匹配导致的。
构建器选型建议
目前没有OpenShift官方专门适配Laravel场景的独立PHP构建器,你可以根据自己的操作成本二选一:
- 第一方案(更稳定、适配性更强):继续使用官方
openshift/php构建器,仅通过参数调整适配Laravel结构,不用引入第三方镜像的兼容性风险 - 第二方案(更省事):使用社区维护的专用Laravel S2I构建器,把适配逻辑内置到镜像里,减少自定义脚本的工作量
第一方案:用官方PHP构建器适配Laravel
不用换镜像源,只需要在创建应用时修正两个核心配置:
- 修正Apache文档根目录指向:添加环境变量
APP_ROOT=/opt/app-root/src/public,把Apache的访问路径直接指向Laravel的public目录,创建命令调整为:oc new-app openshift/php~ssh-git-uri \ --env=APP_ROOT=/opt/app-root/src/public - 补充Laravel必需的构建步骤:默认S2I流程只会拉取源码,不会自动执行Composer依赖安装、目录权限设置等操作,需要在你的Git项目根目录添加
.s2i/bin/assemble自定义脚本,脚本内容为:# 复用官方构建器的原有装配逻辑 source $STI_SCRIPTS_PATH/assemble # 安装生产环境依赖 composer install --no-dev --optimize-autoloader # 自动生成应用密钥 php artisan key:generate # 给Laravel需要写入权限的目录配置正确权限 chmod -R 775 storage bootstrap/cache - 最后通过
oc set env命令把Laravel运行需要的环境变量(数据库连接、缓存驱动等)注入到Pod中即可。
第二方案:使用社区s2i-laravel构建器
这个社区构建器已经把上面提到的路径映射、Composer安装、权限配置等逻辑全部内置,不需要你额外写自定义脚本,具体操作步骤为:
- 把对应的构建器镜像导入到当前OpenShift项目的镜像流中,方便后续S2I流程直接调用:
oc import-image s2i-laravel:latest \ --from=docker.io/codecasts/s2i-laravel:latest \ --confirm - 直接使用这个本地导入的构建器镜像创建应用,命令和之前的写法完全一致:
oc new-app s2i-laravel~ssh-git-uri - 注意:这个社区镜像的维护节奏和官方镜像有差异,使用前需要确认镜像内置的PHP版本和你当前使用的Laravel版本要求是否匹配,避免依赖兼容性问题。
新手常见踩坑提醒
- 不要在项目根目录存放额外的
index.html测试文件,否则Apache可能会优先加载这类静态文件,跳过Laravel的入口逻辑 - 不要把
vendor目录提交到Git仓库中,S2I构建阶段会自动完成依赖安装,提交反而会导致版本冲突 - 构建出现异常时,优先用
oc logs build/<应用名>-<构建序号>命令查看构建日志,定位Composer安装、权限配置环节的报错
内容的提问来源于stack exchange,提问作者Nice91
相关产品推荐
相关产品推荐

