树莓派可稳定运行PHP,需通过apt安装ARM适配版本并配置Web服务器;默认PHP版本依系统而异,须正确设置路径、权限与服务重启。

树莓派默认不带PHP,但能跑,而且跑得稳
树莓派用的是 ARM 架构的 Linux 系统(通常是 Raspberry Pi OS),和 x86 服务器一样支持 PHP,只是不能直接用 php 命令——得自己装。官方源里就有预编译好的 ARM 版本,不用编译,装完就能用。
用 apt 安装 PHP 最省事,别碰源码编译
源码编译在树莓派上慢、容易出错、还可能缺依赖。Raspberry Pi OS 的 apt 源已提供适配 ARM 的 php 包,推荐直接装:
- 运行
sudo apt update && sudo apt install php php-cli php-fpm php-mbstring php-xml php-zip(常用扩展一并装上) -
php -v能看到版本说明装成功了 - 注意:不同系统版本默认 PHP 版本不同——Raspberry Pi OS Bookworm(2023 年后)默认是 PHP 8.2;Bullseye 是 PHP 8.0;太老的系统可能只有 PHP 7.4,
apt list --installed | grep php可确认 - 别手动加第三方 PPA 或第三方仓库,ARM 兼容性没保障,
E: Unable to locate package php8.3这类错误基本都源于乱加源
Apache 或 Nginx 都能跑 PHP,但配置路径容易写错
PHP 装好只是第一步,Web 服务要能调用它。Raspberry Pi OS 默认用 Apache,Nginx 需手动装。关键不是选哪个,而是路径对不对:
- Apache 下确认
/etc/apache2/mods-enabled/php8.x.load存在(x 是实际版本号),没有就a2enmod php8.x - Nginx 需配
fastcgi_pass,常见坑是写成127.0.0.1:9000却忘了php-fpm默认监听的是 Unix socket:/run/php/php8.x-fpm.sock - 测试文件别放错位置:
/var/www/html/test.php,内容写<?php echo phpinfo(); ?>,浏览器访问http://raspberrypi.local/test.php才有效 - 权限问题常被忽略:确保
www-data用户能读取你的 PHP 文件,chmod 644 test.php和chown pi:www-data test.php很有必要
性能够用但别当生产服务器用
树莓派跑 PHP 开发、小工具、家庭自动化后台完全没问题,但几个现实限制得心里有数:
立即学习“PHP免费学习笔记(深入)”;
- 内存吃紧时
php-fpm容易 OOM,建议把pm.max_children改成 2~3(默认可能是 5),配置文件在/etc/php/8.x/fpm/pool.d/www.conf - SD 卡 I/O 是瓶颈,
opcache.enable=1必开(默认已开),但别指望 Composer 频繁安装包——卡顿明显 - USB 接口供电不足可能导致外接硬盘挂载失败,进而让 PHP 的
fopen()报Permission denied,这不是 PHP 问题,是硬件供电问题 - 调试时别只看
php -l,真实请求失败往往卡在error_log里——日志默认在/var/log/php8.x-fpm.log或 Apache 的/var/log/apache2/error.log
最常被跳过的其实是重启服务:改完 PHP 配置不 sudo systemctl restart php8.x-fpm,改完 Apache 不 sudo systemctl reload apache2,再对的配置也白搭。



















