PHP 怎么Helm部署

本文目录导读：

1. 📚 目录导读（Table of Contents）
2. 第一部分：为什么 PHP 需要 Helm 部署？
3. 第二部分：前置准备 —— Docker 化你的 PHP 应用
4. 第三部分：Helm 核心概念速览
5. 第四部分：实战演练 —— 5 步编写 PHP 应用的 Helm Chart
6. 第五部分：高级技巧与最佳实践
7. 第六部分：常见问题 Q&A
8. 结语：从“能跑”到“可运维”的蜕变

** PHP 应用容器化上云指南：从零到一实现 Helm 部署与版本管理

📚 目录导读（Table of Contents）

• 第一部分：为什么 PHP 需要 Helm 部署？—— 从传统 FTP 到云原生
• 第二部分：前置准备 —— Docker 化你的 PHP 应用（Dockerfile 精讲）
• 第三部分：Helm 核心概念速览（Chart、Release、Repository）
• 第四部分：实战演练 —— 5 步编写 PHP 应用的 Helm Chart
• 第五部分：高级技巧 —— 环境隔离、ConfigMap 管理与滚动升级
• 第六部分：常见问题 Q&A（构建失败/连接数据库/权限报错）
• 从“能跑”到“可运维”的蜕变

第一部分：为什么 PHP 需要 Helm 部署？

在过去的十年里,90% 的 PHP 项目（如 Laravel、ThinkPHP、WordPress）都运行在传统的 LAMP 或 LNMP 架构上，开发者习惯用 WinSCP 上传代码，或者在服务器上手动执行 git pull，但如今，当你的业务需要快速扩容、灰度发布以及跨环境（开发/测试/生产）一致性时，传统方式开始显得力不从心。

Helm 作为 Kubernetes（K8s）的包管理工具，相当于 Ubuntu 的 apt-get 或 CentOS 的 yum，它最大的意义在于：将 PHP 应用及其依赖（Nginx、PHP-FPM、MySQL 配置）打包成一个可复制的“安装包”（Chart），这意味着，你只需一条 helm install 命令，就能在任意 K8s 集群中复现一套完全相同的 PHP 运行环境，彻底告别“在我机器上是好的，怎么到你那就报错”的尴尬。

第二部分：前置准备 —— Docker 化你的 PHP 应用

Helm 部署的前提是你的 PHP 代码已经“容器化”，这里不建议使用 php:apache 这种臃肿的基础镜像，推荐使用 PHP-FPM + Nginx 分离架构（这也符合 K8s 多容器 Pod 的设计理念）。

核心 Dockerfile 示例（仅做精髓提炼）：

# 第一阶段：依赖安装（Composer）
FROM composer:2 AS vendor
COPY app/composer.json app/composer.lock ./
RUN composer install --ignore-platform-reqs --no-scripts
# 第二阶段：运行环境
FROM php:8.2-fpm-alpine
RUN docker-php-ext-install pdo_mysql redis
COPY --from=vendor /app/vendor /var/www/html/vendor
COPY app/ /var/www/html

关键点：必须通过 .dockerignore 文件排除 .git 和 storage/logs，否则镜像体积会暴增。

第三部分：Helm 核心概念速览

在写 Chart 之前，先明确三个角色（建议配合 helm create myphp 命令生成骨架）：

1. Chart：一个包含 PHP 应用所有 K8s 资源模板的文件夹（如 deployment.yaml、service.yaml）。
2. Release：Chart 的一次运行实例。helm install my-laravel ./myphp 会创建一个名为 my-laravel 的 Release。
3. Values：配置字典，通过 values.yaml 注入不同环境的差异（比如生产环境数据库地址、Debug 开关）。

第四部分：实战演练 —— 5 步编写 PHP 应用的 Helm Chart

我们以部署一个 Laravel 应用 为例，不涉及复杂业务，只讲骨架。

Step 1：定义 deployment.yaml（核心模板）

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-php
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: {{ .Release.Name }}-php
  template:
    metadata:
      labels:
        app: {{ .Release.Name }}-php
    spec:
      containers:
      - name: php-fpm
        image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
        ports:
        - containerPort: 9000
        env:
        # 将 Laravel 的 APP_ENV 指向 Helm values 里定义的变量
        - name: APP_ENV
          value: "{{ .Values.env.APP_ENV }}"

Step 2：编写 values.yaml（配置与默认值分离）

replicaCount: 2
image:
  repository: registry.mycompany.com/php-laravel
  tag: v1.2.0
env:
  APP_ENV: production
  APP_DEBUG: "false"
  DB_HOST: "mysql-master"

Step 3：处理 Nginx 与 PHP-FPM 的联动 由于 Nginx 和 PHP-FPM 需要 fastcgi_pass 通信，建议将 Nginx 写成独立的 deployment.yaml，暴露 80 端口，然后通过 K8s Service 内部解析到 PHP-FPM Pod，此时可以使用 Helm 的 include 函数或者直接写死 Service 名称，但为了可维护性，建议使用模板变量。

Step 4：使用 ConfigMap 挂载 php.ini 或 Nginx 配置

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ .Release.Name }}-nginx-config
data:
  default.conf: |
    server {
        listen 80;
        root /var/www/html/public;
        index index.php;
        location ~ \.php$ {
            fastcgi_pass {{ .Release.Name }}-php:9000;
        }
    }

然后在 Deployment 的 volumeMounts 里引用该 ConfigMap。

Step 5：执行安装与升级

# 安装
helm install my-release ./myphp --namespace prod --values prod-values.yaml
# 升级（修改了 values 或代码后）
helm upgrade my-release ./myphp --reuse-values
# 回滚（版本管理）
helm rollback my-release 1

第五部分：高级技巧与最佳实践

• 环境隔离：不要为每个环境复制 Chart，而是维护三个 values-*.yaml 文件，通过 -f 参数切换。
• 优雅停机：PHP-FPM 进程在 Pod 被删除前，需要处理完当前请求，请在 Deployment 中设置 terminationGracePeriodSeconds: 30，并在容器中捕获 SIGTERM 信号。
• 依赖管理：如果你的 PHP 应用依赖 Redis/MySQL，可以考虑使用 Helm 的 Subchart 功能，将中间件打包到一起，或者通过 helm repo add bitnami 引入公共依赖。

第六部分：常见问题 Q&A

Q1：执行 helm install 时提示 Error: failed to download "php"？

答：不要直接 helm install php，你需要先构建自己的 Chart 包，或者从可靠的仓库（如 Bitnami）下载，若报错是 not found，请检查你的 Chart 根目录下是否缺少 Chart.yaml 文件。

Q2：PHP 容器启动后，访问网页出现 502 Bad Gateway。

答：这通常是因为 Nginx 无法连到 PHP-FPM 的 9000 端口，排查步骤：

1. 在 Nginx Pod 内执行 wget http://<php-svc-name>:9000 看能否通信。
2. 检查 PHP-FPM 的 listen = 9000 是否被注释。
3. 重点检查 Helm 模板中的 Service 名称是否拼写错误（建议使用 {{ .Release.Name }}-php 一致的命名）。

Q3：如何更新 PHP 代码后，让 Helm 自动滚动更新？

答：Helm 默认不会因为镜像 Tag 不变而重新部署，你需要修改 values.yaml 中的 tag（例如从 v1.0 改为 v1.1），helm upgrade，或者使用 --set image.tag=latest 强制刷新，但生产环境强烈不建议使用 latest