当前位置:

首页 > 编程开发 > 全面详尽的PHP环境搭建教程(包括 Windows、Linux和macOS)

全面详尽的PHP环境搭建教程(包括 Windows、Linux和macOS)

前言 PHP,全称是Hypertext Preprocessor,一种被广泛使用的开源脚本语言,特别适合做Web开发,而且能直接嵌入HTML里。要开始用PHP写代码,第一步当然是在本地或服务器上把PHP的运行环境搭起来。这篇教程会详细拆解如何在Windows、Linux和macOS这三大操作系统上搭

本文目录

    前言

    PHP,全称是Hypertext Preprocessor,一种被广泛使用的开源脚本语言,特别适合做Web开发,而且能直接嵌入HTML里。要开始用PHP写代码,第一步当然是在本地或服务器上把PHP的运行环境搭起来。这篇教程会详细拆解如何在Windows、Linux和macOS这三大操作系统上搭建PHP开发环境,手动搭和用集成环境两种方式都会讲到,配置步骤和注意事项也都安排得明明白白,希望能帮大家顺利完成环境搭建,少走弯路。

    PHP 环境搭建概述

    在写PHP程序之前,得先有个能跑PHP脚本的环境。这个环境通常包含三样东西:

    • Web 服务器:比如Apache、Nginx,负责处理HTTP请求。
    • PHP 解析器:用来解释和执行PHP脚本。
    • 数据库服务器:比如MySQL、MariaDB,用来存数据、管数据。

    为了方便开发者,市面上有不少把上面这些组件打包在一起的安装包,比如XAMPP、WAMP、MAMP,一次安装就能搞定所有必要组件,省去了手动配置的麻烦。

    在 Windows 上搭建 PHP 环境

    使用集成环境 XAMPP

    XAMPP 是一个特别省心的选择,它把Apache、MariaDB、PHP和Perl全都打包在一起,Windows、Linux、macOS都能用。对于新手或者想快速搭建环境的开发者来说,用XAMPP再合适不过了。

    安装步骤

    1. 下载 XAMPP

      去XAMPP官方网站,下载适合Windows的最新版本。

    2. 运行安装程序

      双击下载好的安装程序(比如 xampp-windows-x64-8.0.0-0-VC15-installer.exe),可能会弹出用户账户控制(UAC)提示,点“是”继续就行。

    3. 选择组件

      在组件选择界面,可以按需勾选要安装的组件。默认情况下,Apache、MySQL、PHP都是选中的。可以根据实际需求,添加或取消其他组件。

      组件 描述
      Apache Web 服务器
      MySQL 数据库服务器
      PHP PHP 解析器
      phpMyAdmin MySQL 管理工具
      FileZilla FTP FTP 服务器(可选)
      Tomcat Ja va 服务器(可选)
    4. 选择安装目录

      选个安装路径,建议直接装在根目录下(比如 C:\xampp),能避免一些权限问题。

    5. 完成安装

      安装完成后,勾选“启动控制面板”选项,然后点“完成”。

    配置和测试

    1. 启动 Apache 和 MySQL

      在XAMPP控制面板里,点“Start”按钮启动Apache和MySQL服务。

    2. 测试 Apache

      在浏览器里输入 http://localhost/,如果能看到XAMPP的欢迎页面,说明Apache跑起来了。

    3. 测试 PHP

      创建一个测试文件:

      • 在 C:\xampp\htdocs\ 目录下,新建一个文件,叫 test.php。

      • 文件里写上这个:

        
        
      • 在浏览器里访问 http://localhost/test.php,应该会显示出PHP的配置信息页面。

    常用配置

    • 更改 Apache 端口

      要是端口80被别的程序占了,可以改一下Apache的监听端口。

      • 打开 C:\xampp\apache\conf\httpd.conf。
      • 把 Listen 80 改成 Listen 8080。
      • 把 ServerName localhost:80 改成 ServerName localhost:8080。
      • 重启Apache服务。
    • 配置虚拟主机

      如果同时开发多个项目,可以配置虚拟主机来方便管理。

      • 编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf,加上这段:

        
        
            DocumentRoot "C:/xampp/htdocs/project1"    ServerName project1.local

        再修改 C:\Windows\System32\drivers\etc\hosts,加上:

        
        
        127.0.0.1   project1.local

    手动安装 Apache、PHP 和 MySQL

    如果对环境的控制要求更高,也可以手动安装和配置每个组件。

    安装 Apache

    1. 下载 Apache

      去Apache Lounge网站,下载适合Windows的二进制版本。

    2. 解压安装

      • 把下载的ZIP文件解压到 C:\Apache24。
    3. 配置环境变量

      • 把 C:\Apache24\bin 添加到系统环境变量 PATH 里。
    4. 测试安装

      • 打开命令提示符,输入 httpd -v,应该会显示Apache的版本信息。
    5. 启动 Apache

      • 以管理员身份运行命令提示符,输入:

        httpd

    安装 PHP

    1. 下载 PHP

      去PHP官方下载页面,选择适合Windows的非线程安全(NTS)版本。

    2. 解压安装

      • 把下载的ZIP文件解压到 C:\PHP。
    3. 配置 PHP

      • 把 php.ini-development 重命名为 php.ini。

      • 编辑 php.ini,设置 extension_dir:

        extension_dir = "C:\PHP\ext"
      • 启用必要的扩展,比如 mysqli、pdo_mysql 这些,把前面的分号去掉就行:

        extension=mysqliextension=pdo_mysql
    4. 配置 Apache 与 PHP 集成

      • 编辑Apache的配置文件 C:\Apache24\conf\httpd.conf,加上这些内容:

        LoadModule php_module "C:/PHP/php7apache2_4.dll"AddHandler application/x-httpd-php .phpPHPIniDir "C:/PHP"
      • 确保 DocumentRoot 指向你的项目目录。

    5. 测试 PHP

      • 在 DocumentRoot 目录下创建 index.php,内容为:

        重启Apache服务,访问 http://localhost/,应该能看到 "Hello, PHP!"。

    安装 MySQL

    1. 下载 MySQL

      去MySQL官方下载页面,选择适合Windows的MSI安装程序。

    2. 安装 MySQL

      • 运行安装程序,选“自定义”安装,按提示完成安装。
      • 配置root用户密码,记好这个密码,后面连接数据库要用。
    3. 测试连接

      • 打开命令提示符,输入:

        mysql -u root -p
      • 输入密码后,应该能进入MySQL命令行界面。

    配置 PHP 连接 MySQL

    • 在 php.ini 里确认已经启用了 mysqli 和 pdo_mysql 扩展。

    • 重启Apache服务,测试PHP连接MySQL:

      connect_error) {    die("连接失败: " . $conn->connect_error);}echo "连接成功";?>

    在 Linux 上搭建 PHP 环境

    Linux是服务器上最常用的操作系统之一,这里以Ubuntu为例,讲讲怎么搭PHP环境。

    使用 LAMP 方案

    LAMP,就是Linux、Apache、MySQL/MariaDB、PHP的组合,经典的Web开发环境。

    安装 Apache

    sudo apt updatesudo apt install apache2

    安装 MySQL 或 MariaDB

    安装 MySQL

    sudo apt install mysql-server

    安装 MariaDB

    sudo apt install mariadb-server

    安装 PHP

    sudo apt install php libapache2-mod-php php-mysql

    配置 Apache

    • 设置 Apache 优先解析 PHP 文件

      编辑 /etc/apache2/mods-enabled/dir.conf,把 index.php 放到第一位:

          DirectoryIndex index.php index.html index.cgi index.pl index.xhtml index.htm
    • 启用必要的模块

      sudo a2enmod php7.4  # 根据实际 PHP 版本

    重启 Apache

    sudo systemctl restart apache2

    测试 PHP

    • 创建测试文件 /var/www/html/info.php,内容为:

    • 在浏览器里访问 http://your_server_ip/info.php,应该会显示出PHP的配置信息页面。

    安装和配置 Nginx、PHP-FPM 和 MySQL

    Nginx是高性能的Web服务器,搭配PHP-FPM能提升PHP应用的性能。

    安装 Nginx

    sudo apt updatesudo apt install nginx

    安装 PHP-FPM

    sudo apt install php-fpm php-mysql

    配置 Nginx

    • 编辑 /etc/nginx/sites-a vailable/default,修改服务器块:

      server {    listen 80;    server_name your_server_ip;    root /var/www/html;    index index.php index.html index.htm;    location / {        try_files $uri $uri/ =404;    }    location ~ \.php$ {        include snippets/fastcgi-php.conf;        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;  # 根据实际 PHP 版本    }    location ~ /\.ht {        deny all;    }}
    • 测试Nginx配置:

      sudo nginx -t
    • 重启Nginx:

      sudo systemctl restart nginx

    测试 PHP

    • 创建测试文件 /var/www/html/info.php,内容同上。
    • 访问 http://your_server_ip/info.php,应该会显示PHP信息。

    在 macOS 上搭建 PHP 环境

    使用 MAMP 集成环境

    MAMP(Macintosh, Apache, MySQL, PHP)是专门为macOS设计的集成环境。

    安装 MAMP

    • 下载 MAMP

      去MAMP官方网站,下载最新版本的MAMP。

    • 安装 MAMP

      • 双击下载的DMG文件,按提示把MAMP拖到“应用程序”文件夹里。
    • 启动 MAMP

      • 进入“应用程序”文件夹,打开MAMP。
      • 点“Start Servers”启动Apache和MySQL。

    配置和测试

    • 测试 Apache 和 PHP

      • 访问 http://localhost:8888/,应该能看到MAMP的欢迎页面。
      • 默认的Web根目录是 /Applications/MAMP/htdocs。
    • 测试 PHP

      • 在 htdocs 目录下创建 test.php,内容为:

      • 访问 http://localhost:8888/test.php,应该会显示PHP信息。

    使用 Homebrew 手动安装

    Homebrew是macOS上的包管理器,用它来安装Apache、PHP和MySQL很方便。

    安装 Homebrew

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    安装 Apache

    brew install httpd
    • 启动Apache:

      sudo brew services start httpd

    安装 PHP

    brew install php
    • 启动PHP-FPM:

      brew services start php

    安装 MySQL

    brew install mysql
    • 启动MySQL:

      brew services start mysql

    配置 Apache

    编辑 /usr/local/etc/httpd/httpd.conf,添加或修改以下内容:

    加载PHP模块:

    LoadModule php_module /usr/local/opt/php/lib/httpd/modules/libphp.so

    设置DirectoryIndex:

    DirectoryIndex index.php index.html

    配置PHP文件的处理:

        SetHandler application/x-httpd-php

    重启Apache:

    sudo brew services restart httpd

    测试 PHP

    • 在 /usr/local/var/www 目录下创建 index.php,内容为:

    • 访问 http://localhost:8080/,应该能看到 "Hello, PHP on macOS!"。

    常见问题及解决方案

    Apache 无法启动

    • 端口被占用

      检查一下是不是有其他服务占用了端口80或8080。

      sudo lsof -i :80

      解决方案:改一下Apache的监听端口,或者停掉占用端口的那个服务。

    PHP 脚本不执行,浏览器直接下载

    • 未配置 PHP 处理

      确认Web服务器已经正确配置了PHP模块。

      解决方案:按照上面的步骤,确保Apache或Nginx已经加载了PHP模块,或者已经配置好了PHP-FPM。

    MySQL 无法连接

    • 密码错误

      检查一下连接时用的用户名和密码对不对。

    • 服务未启动

      确认MySQL服务已经启动。

      sudo systemctl status mysql

    权限问题

    • 文件权限不足

      确保Web根目录和PHP文件有正确的权限。

      sudo chown -R www-data:www-data /var/www/htmlsudo chmod -R 755 /var/www/html

    防火墙阻止访问

    • 检查防火墙设置

      确保服务器的防火墙允许HTTP和HTTPS流量。

      sudo ufw allow 'Apache Full'

    总结

    搭建PHP开发环境,是开始PHP编程的第一步。不管你是用Windows、Linux还是macOS,这篇教程都提供了详细的步骤和注意事项,希望能帮你顺利搞定环境配置。

    • Windows 用户:可以用XAMPP这样的集成环境,快速搭建;也可以手动安装Apache、PHP和MySQL,获得更高的灵活性。
    • Linux 用户:LAMP方案是经典选择,或者用Nginx和PHP-FPM来提升性能。
    • macOS 用户:MAMP提供了方便的集成环境;通过Homebrew手动安装则能更好地掌控配置。

    实际开发中可能会遇到各种问题,这篇教程也提供了一些常见问题的解决方案。希望这篇教程能帮你顺利搭建PHP开发环境,开启你的PHP编程之旅。

    参考资料

    • PHP 官方文档
    • Apache 官方文档
    • MySQL 官方文档
    • XAMPP 官方网站
    • MAMP 官方网站
    • Homebrew 官方网站

    全面详尽的PHP环境搭建教程(包括 Windows、Linux和macOS)

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    php环境搭建 xp_xp中搭建php环境安装php并配置
    php环境搭建 xp_xp中搭建php环境安装php并配置

    在Windows XP上配置PHP环境:一步步带你走通 和上一篇文章一样,这里也提供了百度云的下载链接以备所需:http://pan.baidu.com/s/1jGZ8xVK 如果你想亲自动手体验下载和配置的全过程,那么请跟着下面的步骤来。 第一步:获取PHP安装包 首先,访问PHP的官方网站下载页

    Windows下MSI安装PHP详细教程
    Windows下MSI安装PHP详细教程

    通过MSI安装包可快速在Windows系统上完成PHP的安装与基础配置。1、从官网下载适用于系统的PHPMSI安装文件,推荐选择VC15x64非线程安全版本。2、运行下载的.msi文件,选择“DevelopmentServer”类型,指定安装路径如C:\php,完成安装向导。3、将PHP安装目录添加至系统环境变量Path中,确保命令行可全局调用php命令。4、打开cmd执行php-v,若显示PHP版本信息则表明安装成功。5、在安装目录中将php.ini-development复制为php.ini,并编辑该

    Windows 11搭建PHP环境的详细教程
    Windows 11搭建PHP环境的详细教程

    1、使用XAMPP可快速部署Apache、MySQL和PHP,适合初学者;2、通过启用IIS并配置PHP实现灵活控制,适用于定制化需求;3、利用WSL2安装Ubuntu系统运行原生Linux版PHP环境,获得标准开发体验。

    Red Hat 8搭建PHP API服务器教程
    Red Hat 8搭建PHP API服务器教程

    首先安装Apache和PHP,再配置防火墙与SELinux。具体为:1.安装httpd并启动服务;2.安装PHP及常用扩展并验证;3.防火墙放行HTTP;4.部署API代码至/var/www/html;5.调整SELinux允许写入和网络连接。

    Docker搭建PHP远程开发环境教程
    Docker搭建PHP远程开发环境教程

    <p>如何高效构建一个稳定的DockerPHP开发环境?答案是使用docker-compose编排PHP-FPM、Nginx和MySQL服务,并优化镜像、卷、网络等配置。具体步骤包括:1.创建docker-compose.yml文件定义服务及其依赖关系;2.配置Nginx的default.conf文件实现与PHP-FPM通信;3.编写Dockerfile安装PHP扩展及Xdebug;4.使用delegated模式优化卷同步性能;5.设置自定义网络实现服务间通信;6.持久化MySQL数据;7.限

    PHP扩展安装与启用方法
    PHP扩展安装与启用方法

    PHP扩展的安装本质是让PHP加载C/C++编写的模块,主要方式包括系统包管理器、PECL、源码编译和Windows预编译DLL。1.Linux/macOS推荐用apt/yum/brew安装官方扩展,自动处理依赖;2.PECL适用于社区扩展如redis,需先装php-dev和编译工具;3.源码编译最灵活,通过phpize、configure、make流程生成.so文件;4.Windows直接下载匹配版本的.dll文件放入ext目录。共同步骤是修改php.ini添加extension=xxx并重启Web服务

    Docker中设置PHP CI/CD管道教程
    Docker中设置PHP CI/CD管道教程

    首先搭建Docker环境并验证安装,接着通过Dockerfile构建PHP镜像并集成Composer,然后在GitHubActions或GitLabCI中配置自动化流水线,触发代码推送后执行依赖安装与单元测试,再通过Nginx反向代理服务暴露Web入口,最后在CI中划分lint、test、deploy阶段,依次进行代码检查、测试覆盖率分析与条件部署,确保流程可控与环境一致。

    PHP环境部署到云服务器详细教程
    PHP环境部署到云服务器详细教程

    部署PHP环境到云服务器的核心步骤包括:1.选择并连接云服务器实例;2.更新系统软件包;3.安装NginxWeb服务器;4.安装PHP和PHP-FPM;5.安装MySQL数据库;6.配置Nginx处理PHP请求;7.部署PHP应用;8.配置防火墙。部署时需注意PHP版本与扩展匹配、Nginx配置准确性、文件权限设置、防火墙端口开放及数据库连接问题,同时建议启用OPcache、优化PHP-FPM进程、配置HTTPS、使用CDN及进行数据库优化。为确保安全性与稳定性,应定期更新系统组件、遵循最小权限原则、启用

    PHP如何开启SOAP支持及配置方法
    PHP如何开启SOAP支持及配置方法

    答案:启用PHP的SOAP扩展需修改php.ini并重启服务,通过phpinfo()验证,区分WSDL与非WSDL模式开发服务,客户端使用SoapClient并处理SoapFault异常。

    PHP环境重置指南\_详细步骤解析
    PHP环境重置指南\_详细步骤解析

    首先备份现有配置文件,再重命名原配置文件,通过包管理工具或源码编译重新安装PHP,确保Web服务器正确集成PHP模块,最后验证环境是否恢复正常运行。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。