php.ini是 PHP 运行时的核心配置文件INI 格式也是 PHP 最核心的配置入口用于定义 PHP 解释器的全局运行参数、功能开关、资源限制、扩展加载、环境适配等关键规则。PHP 启动时无论是 CLI 命令行模式、FPM 进程模式还是 Apache/Nginx 模块模式会优先读取该文件其配置直接决定 PHP 程序的运行行为、性能、安全和功能边界。简单来说开发者 / 运维人员无需修改 PHP 源码仅通过调整 php.ini 中的参数就能定制 PHP 的运行规则无需重启应用仅需重启 Web 服务器如 Nginx/Apache或 PHP-FPM 进程即可生效CLI 模式下每次执行都会重新读取。一、php.ini 的核心功能分类配置类别核心作用典型参数示例基础环境配置定义 PHP 运行的基础环境、编码、错误显示等default_charset UTF-8资源限制限制 PHP 进程占用的内存、执行时间、上传文件大小等避免资源耗尽memory_limit 128M安全配置管控文件访问、函数禁用、输入过滤等降低安全风险disable_functions exec扩展加载启用 / 禁用 PHP 扩展如 MySQL、Redis、GD 等extension mysqli.so输出控制配置输出缓冲、页面跳转、字符编码等output_buffering On会话Session定义 Session 存储方式、有效期、Cookie 关联等session.gc_maxlifetime 1440文件操作配置文件上传路径、大小限制、临时目录等upload_max_filesize 2M错误处理控制错误报告级别、日志存储、是否显示错误信息error_reporting E_ALL数据库适配配置默认数据库连接、字符集、持久化连接等部分扩展专属mysqli.default_charset utf8二、关键配置项详解高频使用资源限制类运维核心max_execution_time 30PHP 脚本最大执行时间秒默认 30 秒适用于避免长耗时脚本占用服务器资源如大数据处理可调至 300 秒memory_limit 128M单个 PHP 进程最大内存占用默认 128M不足时会报 “Allowed memory size exhausted” 错误upload_max_filesize 2M单个上传文件的最大大小需配合post_max_sizePOST 请求总数据大小使用且post_max_size需大于等于upload_max_filesize。安全类防护核心disable_functions exec,system,passthru禁用高风险系统函数防止恶意代码执行系统命令open_basedir /var/www/html/限制 PHP 只能访问指定目录内的文件防止跨目录读取敏感文件如/etc/passwdallow_url_fopen Off禁止 PHP 通过fopen()等函数访问远程 URL如 http/ftp降低远程代码执行风险。错误处理类开发 / 调试核心display_errors On/Off开发环境设为 On显示错误信息生产环境必须设为 Off避免泄露代码 / 配置信息error_reporting E_ALL ~E_NOTICE控制错误报告级别E_ALL显示所有错误~E_NOTICE排除通知类提示error_log /var/log/php/error.log指定错误日志存储路径生产环境需开启便于排查问题。扩展加载类功能扩展PHP 大部分核心功能如数据库、图形处理、缓存依赖扩展需在php.ini中启用ini123456; 启用 MySQLi 扩展Linux 下后缀为 .soWindows 下为 .dllextension mysqli; 启用 Redis 扩展extension redis; 启用 GD 图形处理扩展extension gd会话配置类Web 开发核心session.save_handler filesSession 存储方式默认文件也可设为 redis/memcachesession.save_path /var/lib/php/sessionsSession 文件存储路径session.cookie_secure On仅允许 HTTPS 传输 Session Cookie防止明文泄露。三、php.ini 的加载优先级关键易错点PHP 可能存在多个php.ini文件不同运行模式 / 环境加载优先级从高到低为命令行指定php -c /自定义路径/php.ini script.php临时覆盖环境变量PHP_INI_SCAN_DIR定义的目录系统默认路径Linux/etc/php/{版本}/{模式}/php.ini如/etc/php/8.1/fpm/php.ini对应 FPM 模式/etc/php/8.1/cli/php.ini对应 CLI 模式WindowsPHP 安装根目录/php.ini或php.ini-development/php.ini-production需重命名为 php.ini编译时指定的默认路径可通过php --ini查看当前生效的配置文件。四、修改 php.ini 后的生效方式CLI 模式无需重启下次执行 PHP 脚本自动读取新配置FPM 模式Nginx/Apache 常用需重启 PHP-FPM 进程如systemctl restart php8.1-fpmApache 模块模式需重启 Apache如systemctl restart apache2。五、补充说明部分配置可通过代码临时覆盖优先级高于 php.ini例如在脚本中通过ini_set(memory_limit, 256M)临时调整内存限制但安全类配置如 disable_functions无法通过代码覆盖区分开发 / 生产环境PHP 安装包默认提供php.ini-development开发版显示错误、宽松限制和php.ini-production生产版隐藏错误、严格限制需根据场景选择验证配置通过php -iCLI 模式或phpinfo()Web 模式可查看当前生效的所有 PHP 配置确认 php.ini 中的修改是否生效。综上php.ini是 PHP 运行的 “总开关”无论是开发调试、性能优化还是安全加固、环境适配都需要通过调整该文件实现是 PHP 运维和开发的核心配置入口。