FrankenPHP内存限制必须PHP层与容器层两级联动，因其实为多线程模型，memory_limit仅控单请求，而OPcache、扩展、autoload等共享内存开销叠加易致OOM；需满足memory_limit×线程数＜容器mem_limit×0.8，并配mem_reservation防冷启动抖动。
不能只设 memory_limit，必须两级联动：PHP 层控单请求，容器层控总用量，缺一不可。
为什么 memory_limit 对 FrankenPHP 整体内存无效
FrankenPHP 是多线程模型，所有请求共享同一进程地址空间。memory_limit 只在 Zend 引擎层面拦截单次脚本执行的内存分配，不影响以下内存开销：
- OPcache 占用的
opcache.memory_consumption（独立于 PHP 内存池） - 已加载扩展、框架 autoload 类映射表、静态资源缓存
- 每个线程的常驻内存（实测 Laravel + OPcache 约 25–40MB/线程）
若容器没设硬上限，一旦总 RSS 超过宿主机可用内存，OOM Killer 会直接杀掉整个 FrankenPHP 进程——不报 Fatal error: Allowed memory size exhausted，连日志都来不及写。
怎么配 memory_limit 和容器 mem_limit 才不冲突
关键原则是：留出缓冲，避免单请求峰值挤占全局资源。配置需满足：memory_limit × 并发线程数 ＜ 容器 mem_limit × 0.8
立即学习“PHP免费学习笔记（深入）”；
- 纯 API 服务（Laravel/Symfony 轻量用法 + OPcache 启用）：单请求常驻约 30MB → 8 线程建议
mem_limit: 384m，对应memory_limit = 256M - WordPress 或含 Mercure/Vulcain：单请求常驻约 40MB → 8 线程起步
mem_limit: 1g，memory_limit = 512M - 16 核高并发场景：线程数自动升到 16，
mem_limit至少2g，否则 OOM 频发 - OPcache 配置要匹配：中型 Laravel 项目（~5k PHP 文件）推荐
opcache.memory_consumption=128+opcache.max_accelerated_files=100000
docker-compose.yml 必须写的两行
只写 mem_limit 不够，mem_reservation 能防止冷启动抖动被误杀：
services:
app:
image: dunglas/frankenphp
mem_limit: 1g
mem_reservation: 512m
mem_reservation 让 Docker 预留基础内存，避免刚启动时因瞬时分配失败触发 OOM；mem_limit 是硬上限，超了就 kill。两者必须同时存在，否则等于裸奔。
验证是否生效的三个命令
部署后务必逐层确认，别信配置写了就等于起效：
- 查 PHP 层：
php -r "echo ini_get('memory_limit');"（确认加载的是你改的php.ini） - 查容器限制：
docker inspect <container> | grep -A 5 Memory（确认Memory和MemoryReservation值正确） - 查运行时 RSS：
docker stats <container>或cat /sys/fs/cgroup/memory/docker/<id>/memory.usage_in_bytes
最容易被忽略的是 OPcache 的 oom_restarts 字段——如果 opcache_get_status()['opcache']['oom_restarts'] 非零，说明 OPcache 自身已在内存压力下反复重启，此时调大 memory_limit 只会让问题更隐蔽。
