FrankenPHP跑Laravel生产环境php.ini推荐配置

夜墨姑娘_8337

夜墨姑娘_8337

2026-10-04

745人浏览

原创

production模式必须启用display_errors = off、log_errors = on、error_log = /var/log/php_errors.log、expose_php = off、opcache.enable = 1、max_execution_time = 0、opcache.revalidate_freq = 0、memory_limit = 512m、phar.readonly = on、phar.require_hash = on、allow_url_fopen = off、disable_functions = exec,passthru,shell_exec,system,proc_open,popen,curl_exec,curl_multi_exec,parse_ini_file,show_source、open_basedir = /app:/tmp、session.save_path = /tmp/php-sessions、upload_tmp_dir = /tmp/uploads、date.timezone = utc。

frankenphp跑laravel生产环境php.ini推荐配置

production模式必须启用的php.ini基础项

FrankenPHP本身不改变PHP核心行为,但它的运行模型(尤其是worker模式)对php.ini中某些配置更敏感。生产环境第一原则:关闭所有调试输出、强制日志落地、禁用危险行为。

  • display_errors = Off 和 display_startup_errors = Off:必须关。FrankenPHP的Caddy层不会拦截PHP错误输出,一旦开启,错误会直接暴露在HTTP响应体中
  • log_errors = On 且 error_log = /var/log/php_errors.log:日志路径必须是FrankenPHP容器或二进制进程有写权限的位置;Docker镜像中建议用/var/log/php_errors.log,本地二进制建议用/tmp/php_errors.log(避免权限问题)
  • expose_php = Off:防止Caddy响应头里泄露X-Powered-By,FrankenPHP默认已设,但显式声明更稳妥
  • opcache.enable = 1:worker模式下OPcache效果更显著,因为常驻进程能长期复用编译后的opcode

FrankenPHP worker模式下要特别注意的缓存与超时配置

启用frankenphp.worker后,PHP进程不再随请求启停,而是长驻内存。此时max_execution_time和opcache.revalidate_freq的行为会和传统FPM不同。

Laravel Creem Agent
Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品,执行心跳检查,管理本地 Laravel支付商店。

下载
  • max_execution_time = 0:worker模式下应设为0。否则单个请求超时会导致整个worker进程被杀,触发重建开销
  • opcache.revalidate_freq = 0:代码更新后需手动触发frankenphp reload或发SIGHUP,设为0可避免每次请求都stat文件,提升稳定性
  • memory_limit = 512M:比常规FPM略高。worker常驻,内存不会自动释放,Laravel容器+队列监听器等可能持续占用
  • realpath_cache_size = 4096K 和 realpath_cache_ttl = 600:FrankenPHP频繁解析public/index.php及vendor路径,增大realpath缓存能减少系统调用

安全加固:phar、远程文件、危险函数三道关

FrankenPHP部署常用于边缘或轻量服务,攻击面更集中,phar反序列化、allow_url_fopen滥用仍是高频入口。

  • phar.readonly = On 和 phar.require_hash = On:必须启用。FrankenPHP默认未改此值,需手动确认;禁用后无法在运行时关闭
  • allow_url_fopen = Off:Laravel自身不用它,但第三方包(如某些旧版SDK)可能依赖。关掉后报错明显,比被利用强
  • disable_functions = exec,passthru,shell_exec,system,proc_open,popen,curl_exec,curl_multi_exec,parse_ini_file,show_source:FrankenPHP无shell调度需求,这些函数全禁;注意curl_exec禁用后,Laravel HTTP Client会fallback到stream,不影响基本功能
  • open_basedir = /app:/tmp:Docker场景下设为/app(项目挂载点)和/tmp(session、cache临时目录),禁止跨目录访问

与Caddy协同时容易忽略的路径与权限细节

FrankenPHP把PHP和Web服务器耦合,但php.ini仍独立生效。很多“500错但无日志”问题其实出在路径权限或session配置不匹配。

  • session.save_path = /tmp/php-sessions:必须显式设置,且确保该路径存在、FrankenPHP进程可读写。Docker中常用RUN mkdir -p /tmp/php-sessions && chmod 777 /tmp/php-sessions
  • upload_tmp_dir = /tmp/uploads:配合Caddy的client_max_body_size使用,否则大文件上传会卡在临时文件写入阶段
  • date.timezone = UTC:FrankenPHP容器默认无时区,Laravel日志、Carbon时间都依赖此项,不设会导致Warning: date(): It is not safe to rely on the system's timezone settings
  • 所有路径(error_log、session.save_path、upload_tmp_dir)都不能落在/app内——Caddy会把它当静态资源尝试返回,造成403或内容泄露
FrankenPHP的php.ini配置难点不在参数数量,而在它和Caddy共享生命周期后,某些“只影响单次请求”的设置(比如max_execution_time)突然有了进程级影响。worker模式下改完配置不重启进程,等于没改。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

frankenphp php laravel

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9904

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5901

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2075

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3688

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4374

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3431

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4897

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3822

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11802

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习