php 8.5.5 不是开箱即用环境,需手动配置php.ini、启用openssl/mbstring/fileinfo扩展并开启opcache;windows需复制重命名配置文件、修正extension_dir路径并重启终端,linux须添加ondrej/ppa源后安装对应扩展包。

PHP 8.5.5 不是“解压就能跑”的开箱即用环境——它默认没 php.ini,没启用任何扩展,php -v 能过,composer install 或 laravel new 必报错。
Windows 下 ZIP 包解压后必须做的三件事
从 windows.php.net/download 下载的 php-8.5.5-nts-Win32-vs17-x64.zip 解压到 D:\php-8.5.5 后,不能直接加进 Path 就完事。
- 复制
php.ini-development并重命名为php.ini(不是php.ini-production,开发阶段需要错误提示) - 编辑
php.ini,确认extension_dir指向绝对路径,例如:extension_dir = "D:/php-8.5.5/ext"(注意斜杠方向,Windows 下反斜杠易被解析为转义) - 把
D:\php-8.5.5加进系统Path,**重启命令行窗口**再执行php -v和php -m验证
哪些 extension 必须手动启用,否则 Composer/Laravel 直接失败
php.ini 里默认所有非核心扩展都注释掉。以下四个不打开,composer create-project laravel/laravel 会卡在 “The openssl extension is required” 或 “mbstring extension is required”。
-
extension=openssl(HTTPS 请求、包下载、JWT 签名必需) -
extension=mbstring(Laravel、Symfony、ThinkPHP 等框架底层字符串操作强依赖) -
extension=fileinfo(上传文件 MIME 类型检测,request->file()->getMimeType()会崩) -
opcache.enable=1(PHP 8.5 已内置opcache,但默认关闭;不开它,每次请求都重新编译,性能损失明显)
Linux 上用 apt 装 PHP 8.5.5,为什么 php -m 看不到扩展
Debian/Ubuntu 官源没有 PHP 8.5 —— apt install php8.5 会报错 “unable to locate package”。必须先加第三方仓库。
- 执行:
sudo add-apt-repository ppa:ondrej/php && sudo apt update - 装主包和关键扩展:
sudo apt install php8.5 php8.5-cli php8.5-mbstring php8.5-opcache php8.5-curl php8.5-zip - 注意:
uri和lexbor是 PHP 8.5 新增的内置扩展,但不会自动启用,需在/etc/php/8.5/cli/php.ini或/etc/php/8.5/apache2/php.ini中显式写extension=uri
Docker 构建时 docker-php-ext-install 报 png.h not found
基础镜像如 php:8.5-fpm 只含运行时,不含编译头文件。直接运行 docker-php-ext-install gd 必然失败。
- 构建时先装依赖:
RUN apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev zlib1g-dev && rm -rf /var/lib/apt/lists/* - 再装扩展:
RUN docker-php-ext-configure gd --with-png-dir=/usr/include --with-jpeg-dir=/usr/include && docker-php-ext-install gd - 最后清理:
RUN apt-get purge -y libpng-dev libjpeg-dev libfreetype6-dev zlib1g-dev && apt-get autoremove -y
最容易被忽略的是:Windows 下改了 php.ini 但没重启 CMD,或 Linux 下改了 /etc/php/8.5/cli/php.ini 却忘了同步改 /etc/php/8.5/fpm/php.ini —— CLI 和 Web 运行环境用的是两套配置文件。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











