PHP应用的Deployment需明确镜像（如php:8.2-apache）、containerPort（80或9000）、command（如["php-fpm"]），并配置健康探针；values.yaml应抽离image、env、phpIniOverrides等可变参数；挂载代码需注意权限（USER www-data）和路径；校验错误常因service.port类型不符或ingress字段废弃导致。
helm chart 里怎么写 PHP 应用的 deployment？
PHP 应用在 K8s 上跑不起来，八成是 deployment 的镜像、端口或启动命令没对上。PHP 容器不是开箱即用的 Web 服务，得明确指定 Web 服务器（比如 nginx + php-fpm 组合）或直接用 php:apache 镜像——但后者不推荐用于生产。
关键点：
-
image要带明确 tag（如php:8.2-apache或自建镜像my-registry.com/my-php-app:v1.2），别用latest -
containerPort必须和实际监听端口一致（80或9000，取决于你用的是 Apache、Nginx 还是纯 fpm） - 如果用
php-fpm单独跑，command和args得显式写上["php-fpm"]，否则容器启动后立刻退出 - 记得加
livenessProbe和readinessProbe，PHP 脚本卡死或 .env 没加载完时，K8s 才能自动重启或摘流量
values.yaml 怎么组织 PHP 项目的配置项？
硬编码在 templates/deployment.yaml 里等于自找麻烦。所有可变参数必须抽到 values.yaml，尤其是和环境强相关的部分。
典型结构建议：
立即学习“PHP免费学习笔记（深入）”；
-
replicaCount：默认设2，避免单点故障 -
image:下拆出repository、tag、pullPolicy，方便 CI/CD 替换 -
env:列出所有必需环境变量，比如APP_ENV: "production"、DB_HOST: "mysql"，不要依赖 ConfigMap 外挂（除非密钥或大配置） -
phpIniOverrides:用 base64 或 multiline string 注入php.ini片段，例如调整upload_max_filesize = 64M，避免重建镜像
PHP 应用挂载代码目录为什么总是 403 或 500？
常见于用 emptyDir 或 configMap 挂载 PHP 文件却忘了权限和入口路径。K8s 默认以 root 用户运行容器，但 Apache/Nginx 的 worker 进程通常以 www-data 启动，导致读不到文件。
解决方式要组合使用：
- 在
Dockerfile里加USER www-data（比在 K8s 层改securityContext.runAsUser更可控） - 挂载代码时用
subPath精确指向index.php所在目录，别整个 repo 目录挂到/var/www/html下还留着.git或vendor权限混乱 - 如果用
initContainer解压或生成代码，确保它也以相同 UID 运行，并chown -R www-data:www-data /app - 检查
volumeMounts.readOnly: true是否误开了——PHP 的cache/、storage/目录必须可写
helm install 报错 “error validating data” 怎么快速定位？
这个错误本质是 K8s API Server 拒绝了 YAML 结构，不是 Helm 本身的问题。PHP Chart 写错最常触发三类校验失败：
-
service.port写成字符串（如"80"）而不是整数，K8s 认为类型不合法 -
ingress.rules[].http.paths[].backend.service.port在 v1.22+ 必须写成name或number，旧写法servicePort已废弃 -
configMapGenerator（helm-secrets 插件常用）生成的内容含非法字符（比如未转义的$或换行），导致最终 YAML 解析失败 - 本地调试用
helm template myphp . --debug | kubectl apply --dry-run=client -f -，比直接helm install更早暴露问题
PHP 的 composer.json 如果被误放进 templates/ 目录，Helm 会尝试渲染它并报模板语法错误——这种低级失误真不少见。
