disable_functions 怎么配才生效?PHP 8 之后它直接移除了函数定义
一、php.net 给 disable_functions 的原文定义
这是虚拟主机、宝塔环境、以及很多"求稳"的运维习惯里都会动的一条指令。先把 php.net 的 ini 核心页对它的说明逐条抄清楚,因为这几句正好解释了日常遇到的几个怪现象:
- 该指令允许禁用某些函数,取值是以逗号分隔的函数名列表;
- 自 PHP 8.0.0 起,禁用一个函数会移除它的定义,从而允许用户层(userland)重新定义它;
- 在 PHP 8.0.0 之前,禁用只是让这个函数不能被调用;
- 只有内建函数(internal functions)能用这条指令禁用,用户自定义函数不受影响;
- 该指令必须写在 php.ini 里,不能写在 httpd.conf。
最后手册还挂了一条明确的 Warning:这条指令可以被绕过,不应被视为共享托管环境下足够的安全措施。

二、PHP 8 行为变化:从"调用报错"变成"函数不存在"
手册"PHP 8.0.0 起禁用函数会移除其定义"这一句,是大量迁移问题的根源。两者表现完全不同:
// PHP 7.4:函数定义仍在,调用被拦
system('id');
// Warning: system() has been disabled for security reasons
// PHP 8.0+:定义被移除
var_dump(function_exists(‘system’)); // bool(false)
system(‘id’); // Fatal error: Call to undefined function system()
由此产生两个直接影响:
- 判断函数是否可用只能用
function_exists(),不能再拿"有没有函数"或is_callable()之外的手段推断。很多老代码里if (function_exists('curl_init'))这类探测写法在 PHP 8 下会走 else 分支 —— 因为禁用后定义真没了。 - 用户可以重新定义同名函数。这既是特性也是风险:如果你的框架里有个叫
exec()的辅助函数,而 php.ini 禁用了内建的 exec,在 PHP 8 下你的 userland exec 会正常工作,看起来"禁用失效了"。手册的 Warning 正是这层意思的一部分。
三、汇总表的三个硬事实:默认值、作用域、邻位指令
从 php.net ini 核心页的汇总表可以读到三条常被忽略的信息:
disable_functions的默认值是空字符串"",即默认不禁任何函数;- 它的作用域标注为 INI_SYSTEM only —— 只能在 php.ini 主配置里设。这直接解释了手册正文那句"必须写在 php.ini,不能写在 httpd.conf":在
.htaccess里写php_value disable_functions ...不会生效(会报 500 或被静默忽略)。 - 相邻的
disable_classes是php.ini only,取值是逗号分隔的类名列表,禁用某类只是阻止该类的实例化;同样只对内建类有效; - 关键更新:
disable_classes自 PHP 8.5.0 起已被移除(REMOVED)。也就是说新版 PHP 里这条路没了。
顺带一句同页的 zend.assertions,很多人会误配:设为 1 时断言代码会被生成并执行(开发模式);设为 0 时仍会生成但运行时被跳过;只有设为 -1 才完全不生成,让断言零成本(生产模式)。生产环境光写 zend.assertions=0 并没有"去掉"断言代码。
官方自带的 php.ini-production 模板里,这一行就是留白待填的:
; This directive allows you to disable certain functions.
; https://php.net/disable-functions
disable_functions =
四、该禁哪些:常见的名单,以及一个务实的边界
php.net 没有给推荐名单(它只给机制),下面是社区与各类加固指南的通行做法,按"被 webshell 用得最多"排序:
; 命令执行类(第一优先)
disable_functions = "exec,passthru,shell_exec,system,proc_open,popen,parse_ini_file,show_source,highlight_file"
; 上表基础上再加:进程/pcntl、部分网络与文件遍历
; pcntl_*、posix_kill、curl_multi_exec、ini_alter、ini_restore、dl
这里必须讲一个务实的边界,否则会把业务禁崩:
- 如果程序需要调用系统命令(ImageMagick 转图、ffmpeg 转码、Composer、git 部署脚本),禁掉
exec/system/proc_open会直接让它们失效。加固与功能要按站点分开配置,不要在同一台机器全局一刀切。 - 禁用
dl()是另一条常被提的:它阻止运行时动态加载扩展。 ini_alter/ini_set类禁用要小心:有些框架运行时会改memory_limit、error_reporting。putenv影响PATH,某些依赖外部命令的程序会因此找不到可执行文件。
更关键的一点:禁用函数不是"防 webshell 的银弹"。手册自己挂了 Warning(可被绕过、不应作为共享环境下的充分措施)。真正管用的是组合:把 upload_dir/data 目录设为不可解析 PHP(Nginx location 加 fastcgi_pass 过滤或 Apache php_admin_flag engine Off)、open_basedir 限制、文件权限收紧、以及 PHP 版本保持更新。
五、写了不生效?先查你改的是哪一份 php.ini
这是被问得最多的现象,而且原因几乎只有一个:改的文件和被加载的文件不是同一份。一条命令确认:
php -i | grep "Loaded Configuration File"
php --ini
# 只看某个函数的当前状态
php -r "var_dump(ini_get('disable_functions'), function_exists('system'));"
排查清单:
- FPM 与 CLI 是两套配置。
/etc/php/8.3/cli/php.ini和/etc/php/8.3/fpm/php.ini独立,只改 CLI 的话网页端不会变(反之亦然)。 - 改了必须重启。ini 是在进程启动时读入的:
systemctl restart php8.3-fpm # 或 php-fpm reload apachectl graceful # mod_php 场景要重启 Apache - 宝塔/云面板有独立 php.ini。面板"PHP 设置"里的路径常指向
/www/server/php/80/etc/php.ini,直接改 /etc 下那份是没用的。 - 确认指令没有重复出现多次。php.ini 里若出现两个
disable_functions,后者覆盖前者 —— 用grep -n disable_functions /etc/php/8.3/fpm/php.ini数一下。 - 确认扩展已装。禁用一个不存在的函数不报错,但也毫无意义。
六、验证是否真的生效(四种测法)
<?php
$fns = ['exec','system','passthru','shell_exec','proc_open','popen','dl','curl_multi_exec'];
foreach ($fns as $fn) {
printf("%-16s exists=%s\n", $fn, var_export(function_exists($fn), true));
}
echo 'ini_get: ' . ini_get('disable_functions') . PHP_EOL;
四种手段交叉验证,最稳:
phpinfo()→ 搜 disable_functions 一行,能看到实际生效的列表(注意别把 phpinfo 留在生产上,它本身就是信息泄露点,看完就删)。- CLI:
php -r "var_dump(function_exists('system'));" - 运行期:
php -m无关,但php -i | grep disable_functions会直接打印当前值。 - 写测试脚本触发一次调用,看错误类型 —— 出现
has been disabled for security reasons说明是 7.x 行为,出现undefined function说明是 8.x 行为。
七、php.ini 之外:还有没有别的"禁用"路子
由于 disable_functions 是 INI_SYSTEM only,多站点分权配置时往往要绕路:
- FPM 池:不同站点用不同的
php-fpm池(不同pm.www.conf)配合php_admin_value,可以在池级覆盖大量指令。但 disable_functions 这条走不通 —— 手册只允许 php.ini;因此需要真隔离时做法是为不同站点跑不同的 PHP 版本 / 不同的 fpm 实例,各自持有一份 php.ini。 - Docker 场景:在镜像里
RUN echo 'disable_functions=...' > /usr/local/etc/php/conf.d/hardening.ini,让 conf.d 下的 ini 文件参与加载 —— 注意conf.d/*.ini是"额外 php.ini",仍属 php.ini 范畴,因此可行,且比改主文件好维护。 - Suhosin 一类扩展(历史方案):提供比 ini 更细的函数黑白名单,但要确认对当前 PHP 版本是否仍支持。
八、常见问题
Q:禁用函数会不会被 .htaccess 覆盖?
A:不会。disable_functions 作用域是 INI_SYSTEM only,手册明确"必须写在 php.ini,不能写在 httpd.conf"。.htaccess 里的 php_value 动不了它,这既是隔离保证也是很多人改不生效的原因。
Q:为什么 PHP 8 上 function_exists('system') 返回 false,而 PHP 7 上返回 true?
A:正是手册那条版本变更:8.0.0 起"禁用一个函数会移除它的定义",7.x 只是"阻止调用"。这也意味着 8.0+ 上你可以自己定义同名函数(function system(...){})来顶替 —— 如果你的安全方案依赖它"绝对不可用",那就不成立。
Q:disable_classes 还能用吗?
A:自 PHP 8.5.0 起已被移除。它的机制是阻止内建类实例化,同样只对内建类有效、只能 php.ini 设置,而且手册同样挂着"可以被绕过、不足以作为共享托管环境的安全措施"这条 Warning。新版本请直接改用其他隔离手段。
Q:只禁用 system 够吗?
A:不够。命令执行入口至少有 exec、passthru、shell_exec、system、proc_open、popen 六个,以及反引号(等价于 shell_exec);只禁一个等于没禁。反过来也别禁 preg_replace、eval 语言结构这类东西 —— eval 不是函数,无法通过 disable_functions 禁用,这是常被误解的一点。
