You need to enable JavaScript to run this app. 如何用OpenShift部署Laravel?openshift/php访问异常及s2i-laravel使用咨询
优惠活动
大模型
产品
解决方案
定价
更多

如何用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

不用换镜像源,只需要在创建应用时修正两个核心配置:

  1. 修正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
    
  2. 补充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
    
  3. 最后通过oc set env命令把Laravel运行需要的环境变量(数据库连接、缓存驱动等)注入到Pod中即可。

第二方案:使用社区s2i-laravel构建器

这个社区构建器已经把上面提到的路径映射、Composer安装、权限配置等逻辑全部内置,不需要你额外写自定义脚本,具体操作步骤为:

  1. 把对应的构建器镜像导入到当前OpenShift项目的镜像流中,方便后续S2I流程直接调用:
    oc import-image s2i-laravel:latest \
      --from=docker.io/codecasts/s2i-laravel:latest \
      --confirm
    
  2. 直接使用这个本地导入的构建器镜像创建应用,命令和之前的写法完全一致:
    oc new-app s2i-laravel~ssh-git-uri
    
  3. 注意:这个社区镜像的维护节奏和官方镜像有差异,使用前需要确认镜像内置的PHP版本和你当前使用的Laravel版本要求是否匹配,避免依赖兼容性问题。

新手常见踩坑提醒

  • 不要在项目根目录存放额外的index.html测试文件,否则Apache可能会优先加载这类静态文件,跳过Laravel的入口逻辑
  • 不要把vendor目录提交到Git仓库中,S2I构建阶段会自动完成依赖安装,提交反而会导致版本冲突
  • 构建出现异常时,优先用oc logs build/<应用名>-<构建序号>命令查看构建日志,定位Composer安装、权限配置环节的报错

内容的提问来源于stack exchange,提问作者Nice91

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.21 06:54:03