本文目录导读:

在树莓派上安装和使用 PHP 主要有以下几种方法,我会从简单到进阶为你详细介绍:
最简单的安装方法(推荐)
使用 apt 直接安装
# 更新软件源 sudo apt update # 安装 PHP 及常用扩展 sudo apt install php php-mysql php-sqlite3 php-curl php-gd php-mbstring php-xml php-zip # 验证安装 php -v
安装完整的 Web 环境(LAMP)
一键安装(适合初学者)
# 安装任务包 sudo apt install tasksel sudo tasksel install lamp-server # 或者直接安装 sudo apt install apache2 php mysql-server
手动安装组件
# 1. 安装 Apache sudo apt install apache2 # 2. 安装 PHP sudo apt install php libapache2-mod-php # 3. 安装 MySQL(可选) sudo apt install mariadb-server # 4. 重启 Apache sudo systemctl restart apache2
安装 Nginx + PHP(性能更好)
# 安装 Nginx sudo apt install nginx # 安装 PHP-FPM sudo apt install php-fpm # 配置 Nginx 使用 PHP sudo nano /etc/nginx/sites-available/default
配置示例:
server {
listen 80;
server_name localhost;
root /var/www/html;
index index.php index.html;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
}
}
其他实用工具安装
安装 Composer(PHP 包管理器)
# 安装依赖 sudo apt install curl wget # 安装 Composer curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer composer --version
安装 PHPMyAdmin(数据库管理)
sudo apt install phpmyadmin sudo ln -s /usr/share/phpmyadmin /var/www/html/phpmyadmin
测试 PHP
创建测试文件
# 创建测试文件 echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/test.php # 如果是 Nginx sudo chmod 755 /var/www/html/test.php
浏览器访问
访问:http://树莓派IP/test.php
常用 PHP 开发建议
设置权限
# 添加用户到 www-data 组 sudo usermod -a -G www-data $USER # 设置目录权限 sudo chown -R $USER:www-data /var/www/html sudo chmod -R 775 /var/www/html
VS Code 开发环境
# 安装 VS Code(可选) sudo apt install code # 推荐安装的扩展: # - PHP IntelliSense # - PHP Debug # - MySQL
性能优化
# 查看 PHP 配置 php -i | grep "Loaded Configuration File" # 优化 PHP-FPM sudo nano /etc/php/8.2/fpm/pool.d/www.conf # 调整内存限制(在 php.ini 中) memory_limit = 256M max_execution_time = 30
常见问题解决
端口被占用
# 检查端口 sudo netstat -tlnp | grep :80 # 如有冲突,修改 Apache 端口 sudo nano /etc/apache2/ports.conf
扩展安装
# 查看已安装扩展 php -m # 搜索并安装扩展 apt search php- | grep 扩展名 sudo apt install php-扩展名
中文乱码问题
// PHP 文件头部添加
header('Content-Type: text/html; charset=utf-8');
总结建议
- 初学者:使用
sudo apt install php快速开始 - Web 服务器:Nginx + PHP-FPM 性能最好
- 全栈开发:安装完整 LAMP 环境
- IoT 项目:配合 GPIO 库,用 PHP 控制硬件
如果你的树莓派配置较低(如 Pi Zero),建议使用轻量级的 Nginx 而非 Apache,需要我详细介绍某个部分吗?