PHP项目需先构建容器镜像，再通过Helm Chart部署：创建标准Chart结构，用templates定义Deployment/Service等资源，values.yaml参数化镜像、端口、PHP配置，ConfigMap/Secret注入运行时配置，最后helm install安装、helm upgrade升级。
如果您希望将PHP项目通过Helm进行标准化部署与生命周期管理，则需将其组织为符合Helm规范的Chart结构。以下是将PHP项目打包为Helm Chart并支持一键安装与升级的具体操作步骤：
一、创建标准Helm Chart目录结构
新建一个符合Helm v3规范的Chart目录，包含必需的元数据文件和模板资源，确保Kubernetes能正确识别并渲染PHP应用配置。
1、执行命令 helm create php-app 生成基础Chart骨架。
2、进入 php-app/ 目录，删除默认的 templates/deployment.yaml 和 templates/service.yaml。
立即学习“PHP免费学习笔记（深入）”；
3、在 charts/ 子目录下创建空文件夹（如需引入依赖Chart）。
4、确认 Chart.yaml 中的 name 字段设为 php-app，version 设为初始语义化版本（如 0.1.0）。
二、编写PHP应用核心模板文件
将PHP项目容器化配置转化为可参数化的Kubernetes清单模板，使镜像、端口、环境变量等可通过values.yaml动态注入。
1、在 templates/ 目录下新建 deployment.yaml，定义使用 {{ .Values.image.repository }}:{{ .Values.image.tag }} 的Pod部署。
2、新建 service.yaml，暴露 {{ .Values.service.port }} 端口，并设置 selector 匹配Deployment的labels。
3、新建 ingress.yaml（若启用），引用 {{ .Values.ingress.host }} 和 {{ .Values.ingress.path }} 构建路由规则。
4、在 templates/_helpers.tpl 中定义通用label函数，如 php-app.fullname，供各资源复用。
三、配置values.yaml实现灵活参数化
通过values.yaml集中管理所有可变配置项，使同一Chart可在不同环境（开发/测试/生产）中重复使用而无需修改模板。
1、清空默认 values.yaml 内容，按层级写入以下结构：
2、设置 image: 下的 repository（如 my-registry/php-apache）、tag（如 8.2-alpine）和 pullPolicy（如 IfNotPresent）。
3、设置 service: 下的 type（如 ClusterIP）、port（如 80）。
4、添加 phpConfig: 块，包含 uploadMaxFilesize、memoryLimit 等自定义PHP.ini参数，供ConfigMap模板引用。
四、构建ConfigMap与Secret以注入PHP配置
将PHP项目所需的运行时配置（如php.ini片段、.env变量）分离为Kubernetes原生资源，避免硬编码进镜像。
1、在 templates/ 中新建 configmap.yaml，使用 {{ .Values.phpConfig }} 渲染键值对，挂载至容器内 /usr/local/etc/php/conf.d/custom.ini。
2、新建 secret.yaml，对 .Values.secrets.envVars 中的键值执行base64编码后注入为环境变量。
3、在 deployment.yaml 的容器定义中添加 envFrom: 引用该Secret，并添加 volumeMounts 挂载ConfigMap。
4、确认挂载路径不覆盖容器内原有PHP配置目录，且权限设置为只读（readOnly: true）。
五、验证Chart语法并执行本地安装
在推送至仓库前，必须验证Chart结构合法性及模板渲染结果，防止因语法错误导致集群部署失败。
1、运行 helm lint php-app/ 检查Chart格式与最佳实践合规性。
2、执行 helm template php-app/ --debug 查看实际生成的YAML清单，确认所有占位符已正确替换。
3、使用 helm install php-app ./php-app --namespace default --create-namespace 在本地集群完成首次部署。
4、通过 kubectl get pods -n default -l app.kubernetes.io/instance=php-app 验证Pod处于 Running 状态。
六、支持版本化升级与回滚
利用Helm Release的版本历史机制，在不中断服务的前提下更新PHP应用镜像或配置。
1、修改 values.yaml 中的 image.tag 为新版本（如从 8.2-alpine 改为 8.3-alpine）。
2、更新 Chart.yaml 中的 version（如从 0.1.0 升至 0.2.0）。
3、执行 helm upgrade php-app ./php-app --reuse-values 触发滚动更新，保留旧values中的非覆盖字段。
4、若升级异常，立即运行 helm rollback php-app 1 回退至上一可用版本（版本号通过 helm history php-app 查询）。
