使用 Localhost 运行 PHP 文件的完整指南-php教程-PHP中文网

使用 Localhost 运行 PHP 文件的完整指南

花韻仙語

发布： 2025-08-01 17:32:11

原创

1019人浏览过

使用 Localhost 运行 PHP 文件的完整指南

本文旨在帮助初学者掌握如何通过 localhost 运行 PHP 文件。我们将介绍必要的环境配置，包括 PHP 的安装与更新，以及如何使用 PHP 内置的 Web 服务器来访问和执行 PHP 代码。通过本教程，你将能够轻松地在本地开发和测试 PHP 项目。

准备工作：安装和配置 PHP

在开始之前，你需要确保你的系统上已经安装了 php。以下是在常见操作系统上安装 php 的步骤：

macOS:

如果你使用的是 macOS，推荐使用 Homebrew 来安装 PHP。

打开终端。
运行以下命令来安装 PHP：

立即学习“PHP免费学习笔记（深入）”；
```
brew install php
```
登录后复制
安装完成后，可能需要配置你的 PATH 环境变量，以便系统能够找到 PHP 可执行文件。Homebrew 会在安装过程中给出提示。

Linux (Debian/Ubuntu):

打开终端。
运行以下命令来安装 PHP：

立即学习“PHP免费学习笔记（深入）”；
```
sudo apt update
sudo apt install php libapache2-mod-php php-mysql
```
登录后复制
libapache2-mod-php 允许 Apache Web 服务器处理 PHP 文件。php-mysql 提供 PHP 连接 MySQL 数据库的功能。

Windows:

你可以从 PHP 官网下载 PHP 的 Windows 版本：https://www.php.cn/link/956f9d4b926a8af07bf32de21edd8eee
选择适合你系统的版本（通常是 Thread Safe 版本）。
下载后，解压到你选择的目录（例如 C:\php）。
配置环境变量：将 PHP 的安装目录添加到系统的 PATH 环境变量中。
配置 PHP：复制 php.ini-development 文件并重命名为 php.ini。根据你的需要修改 php.ini 文件中的配置，例如启用扩展。

启动 PHP 内置 Web 服务器

PHP 提供了一个内置的 Web 服务器，方便开发者在本地进行测试。以下是启动它的步骤：

一览运营宝

一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

查看详情

打开终端或命令提示符。
导航到你的 PHP 文件所在的目录。例如，如果你的 index.php 文件位于 C:\xampp\htdocs\superschool 目录下，则运行：
```
cd C:\xampp\htdocs\superschool
```
登录后复制
运行以下命令来启动 PHP 内置 Web 服务器：
```
php -S localhost:8080
```
登录后复制
这条命令告诉 PHP 启动一个 Web 服务器，监听 localhost 的 8080 端口。你可以根据需要更改端口号。

访问你的 PHP 文件

启动 Web 服务器后，你可以在浏览器中访问你的 PHP 文件。在浏览器地址栏中输入：

http://localhost:8080/index.php

登录后复制

如果一切配置正确，你的 PHP 代码将会被执行，并在浏览器中显示结果。

解决 HTTP ERROR 500 错误

HTTP ERROR 500 错误通常表示服务器内部错误。这可能是由于 PHP 代码中的语法错误、缺少依赖项或服务器配置问题引起的。

以下是一些常见的解决方法：

检查 PHP 错误日志： PHP 错误日志通常包含有关错误的详细信息。你可以在 php.ini 文件中配置错误日志的路径。查找类似于 error_log 的设置项。
检查 PHP 代码中的语法错误： 使用代码编辑器或 IDE 可以帮助你检测语法错误。
确保所有必需的扩展都已启用： 如果你的 PHP 代码依赖于某些扩展（例如 MySQL 扩展），请确保这些扩展已在 php.ini 文件中启用。可以通过取消注释 extension=mysqli 类似的行来启用扩展。
检查文件权限： 确保 Web 服务器进程有权访问你的 PHP 文件。

示例：简单的 PHP 页面

创建一个名为 index.php 的文件，包含以下代码：

<!DOCTYPE html>
<html>
<head>
    <title>PHP 测试</title>
</head>
<body>
    <h1>欢迎来到 PHP 世界！</h1>
    <?php
        echo "<p>当前时间是：" . date("Y-m-d H:i:s") . "</p>";
    ?>
</body>
</html>

登录后复制

将此文件保存到你的 Web 服务器根目录（例如 C:\xampp\htdocs\superschool）。然后，在浏览器中访问 http://localhost:8080/index.php，你应该能够看到包含当前时间的欢迎页面。