PHP 8.3 部署到 Kubernetes 需显式启动 php-fpm、手动安装 curl 等扩展、谨慎配置 opcache.preload，因官方镜像默认不启服务、不装扩展、预加载校验更严。

PHP 8.3 部署到 Kubernetes 不是“换镜像就能跑”，关键卡点在 镜像兼容性、FPM 启动方式变更、以及默认不暴露端口——直接套用 PHP 8.2 或更早的 YAML，大概率会卡在 CrashLoopBackOff 或 Connection refused。

---

php:8.3-fpm 容器启动失败：没暴露端口，也没监听

PHP 8.3 的官方 php:8.3-fpm 镜像默认 不启动 FPM 进程，也不监听任何端口（不像旧版自动启 php-fpm）。它只提供运行时环境，需要你显式调用 php-fpm 并指定配置。

• 常见错误现象：kubectl logs 显示容器立即退出，或 kubectl describe pod 中看到 State: Terminated, Reason: Completed

• 正确做法：必须在 command 或 entrypoint 中显式启动 php-fpm，并确保配置文件存在

  立即学习“PHP免费学习笔记（深入）”；

  

  btpanel phpsite 宝塔面板PHP网站

  宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

  下载

• 示例片段（Deployment 中的容器部分）：

  containers:
  </li><li><p>name: php
  image: php:8.3-fpm
  command: ["php-fpm"]
  args: ["-F", "-R"]  # -F 前台运行，-R 重载配置（如挂载了自定义 php.ini）
  ports:</p><ul><li>name: fpm
  containerPort: 9000
  protocol: TCP

注意：php:8.3-apache 是另一条路，它自带 Apache，但默认监听 80；若你用 Nginx + PHP-FPM 架构，别混用 —— php:8.3-apache 和 php:8.3-fpm 是两个独立镜像，用途不同

---

php:8.3 的 opcache.preload 在容器里容易崩，得关或配稳

PHP 8.3 加强了预加载（opcache.preload）校验，但容器内路径不稳定（比如挂载 ConfigMap、或用 emptyDir），极易触发 Fatal error: Preloaded file ... could not be loaded。

• 使用场景：你启用了 opcache.preload="/var/www/preload.php"，且该文件通过 ConfigMap 挂载
• 容易踩的坑：
  • ConfigMap 挂载后文件权限是 644，但 PHP 8.3 要求预加载文件可读且不能被其他进程写入（否则拒绝加载）
  • 挂载点路径和 preload 配置中的路径不一致（比如 ConfigMap 挂在 /etc/php/conf.d/preload.ini，但文件实际在 /var/www/preload.php）
• 解决建议：
  • 开发/测试阶段先注释掉 opcache.preload 行，确认基础运行正常
  • 生产启用时，确保 preload 文件：
    • 用 initContainer 复制进容器本地路径（而非直接挂载）
    • 或改用 subPath 挂载单个文件，并设 defaultMode: 0444
  • 更稳妥：干脆禁用预加载，靠 opcache.validate_timestamps=0 + opcache.revalidate_freq=60 平衡性能与稳定性

---

php:8.3-cli 和 php:8.3-fpm 的 curl 扩展默认不带，HTTP 请求会报错

PHP 8.3 官方镜像（尤其是 Alpine 版）默认不安装 curl、mbstring、json 等常用扩展，哪怕你只是用 file_get_contents("https://...")，也会因缺少 openssl 或 curl 报 failed to open stream: Unable to find the socket transport "https"。

• 判断方法：docker run --rm php:8.3-cli php -m | grep -E "(curl|openssl|mbstring)" → 大概率为空
• 必须手动装（以 Alpine 为例）：

  RUN apk add --no-cache \
    curl-dev \
    openssl-dev \
    && docker-php-ext-install \
      curl \
      mbstring \
      json \
      opcache

• 如果你用的是 php:8.3-fpm-alpine，这段必须加在 Dockerfile 里；跳过就等于放弃 HTTPS 请求能力
• Debian/Ubuntu 基础镜像同理，要 apt-get install -y libcurl4-openssl-dev 再 docker-php-ext-install curl

---

Kubernetes 上跑 php:8.3 最容易被忽略的，不是语法升级，而是镜像行为变了：它不再“开箱即用”，而是更贴近最小化原则。你得亲手告诉它“怎么起服务”“装什么扩展”“从哪读配置”。漏掉任意一环，Pod 就不会 Ready。