To set up a PHP development environment, you need to select the appropriate tools and install the configuration correctly. ①The most basic PHP local environment requires three components: the web server (Apache or Nginx), PHP itself and database (such as MySQL/MariaDB); ② It is recommended that beginners use integration packages such as XAMPP or MAMP, which simplify the installation process. XAMPP is suitable for Windows and macOS. After installation, the project files are placed in the htdocs directory and accessed through localhost; ③MAMP is suitable for Mac users and supports convenient switching of PHP versions, but the free version has limited functions; ④ Advanced users can manually install them by Homebrew, and can achieve more flexible control in macOS/Linux systems through terminal commands; ⑤ Common precautions include ensuring that the port is not occupied, the PHP version matches project requirements, enabling necessary extensions, and setting permissions correctly. After the configuration is completed, the environment usually runs stably, which facilitates subsequent development and problem investigation.

Setting up a PHP development environment might seem daunting if you're just starting out, but it's actually straightforward once you understand the key components involved. You don't need to overcomplicate things—just get a few tools working together and you're good to go.

What do you really need for a PHP local environment?

A basic PHP setup requires three main pieces: a web server, PHP itself, and a database. The most common combo is Apache (or Nginx), PHP, and MySQL/MariaDB. These are often packaged together in tools that simplify installation.

• Apache or Nginx : Handles HTTP requests and serves your PHP files.
• PHP : Processes the actual PHP code and returns HTML to the browser.
• MySQL / MariaDB : Stores data for dynamic websites like blogs or user systems.

You can install each separately, but beginners usually benefit more from using an all-in-one package.

Option 1: Use XAMPP (great for Windows and macOS)

XAMPP is one of the easiest ways to get started. It bundles Apache, PHP, MySQL, and phpMyAdmin—all in one installer.

How to set it up:

1. Download XAMPP from the official site (make sure it matches your OS).
2. Run the installer and choose where to install it (default is fine).
3. Start Apache and MySQL from the XAMPP control panel.
4. Put your PHP files into the htdocs folder inside the XAMPP directory.
5. Access them via http://localhost/your-folder-name .

A common mistake is trying to run XAMPP on a system where port 80 is already taken (like by Skype or IIS). If Apache doesn't start, check which app is using port 80 and either stop it or change Apache's port in the config.

Option 2: MAMP (another solid choice, especially for Mac users)

MAMP works similarly to XAMPP but is known for being smoother on macOS. It also lets you easily switch between PHP versions.

Key points when using MAMP:

• The default document root is htdocs under the MAMP folder, not system-wide /Applications .
• To use localhost paths like http://localhost:8888/myproject , place your project in the correct htdocs folder.
• You can change the ports if needed (eg, to avoid using 8888 and go straight to port 80).

One thing to note: MAMP Free version has some limitations, so if you want advanced features like command-line access to PHP, you may want to look into the Pro version or another method.

Option 3: Manual setup with Homebrew (for macOS/Linux users who like control)

If you prefer more control and are comfortable with the terminal, installing PHP and related tools manually can be rewarding.

Basic steps:

1. Install Homebrew if you haven't already ( /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" )
2. Install PHP: brew install php
3. Install MySQL: brew install mysql
4. Start services: brew services start mysql and brew services start php
5. Set up your document root and configure php.ini as needed

This gives you a cleaner, more modern setup, but troubleshooting issues like path problems or missing extensions can take time if you're new.

A few gotchas to watch out for

• Make sure your PHP version matches what your project needs. Some older projects won't work well with PHP 8.
• Extensions like mysqli , pdo , and mbstring are commonly needed—check they're enabled in php.ini .
• Permissions matter, especially on Linux/macOS. Your web server must have read access to your project files.

Basically that's it. Once everything is running, you'll barely think about the environment again unless something breaks. And even then, knowing how each piece fits together make debugging much easier.

The above is the detailed content of PHP beginner guide: Detailed explanation of local environment configuration. For more information, please follow other related articles on the PHP Chinese website!