To set up a PHP development environment, choose a stack like XAMPP for simplicity or Docker for consistency, install PHP and configure php.ini, set up a local server with virtual hosts, and include essential tools like Xdebug, Composer, and Git. Begin by selecting a development stack: XAMPP is beginner-friendly, Docker ensures environment consistency, and manual setup offers advanced control. Install PHP via package managers or bundled stacks, verify installation with php -v, and configure display_errors, upload sizes, and required extensions in php.ini. Use Apache from XAMPP or MAMP to serve files from htdocs or set up virtual hosts for cleaner URLs by editing httpd-vhosts.conf and the hosts file. For debugging and tooling, implement Xdebug for tracing and breakpoints, PHPStan or Psalm for static analysis, Composer for dependency management, and Git for version control. Once configured, this environment supports building robust PHP applications efficiently.

Setting up a PHP development environment might sound technical, but once you get the flow, it becomes second nature. Whether you're building a simple script or a full-scale web app, having the right tools and setup makes all the difference.

Choosing Your Development Stack

The first thing you'll want to decide is which stack you're going with. Most PHP developers go for LAMP (Linux, Apache, MySQL, PHP) or WAMP/XAMPP on Windows. If you're on macOS, MAMP is another solid option.

• WAMP/XAMPP gives you everything pre-packaged — server, database, PHP — all in one install
• Docker setups are becoming more popular for consistency across environments
• For advanced users, manually installing Apache/NGINX, PHP, and MySQL offers the most control

Each has pros and cons. Beginners usually find XAMPP easier to start with because of how straightforward the installation is. Meanwhile, Docker helps avoid "it works on my machine" issues later down the line.

Installing PHP and Setting Up the Basics

Once your stack is chosen, it’s time to install PHP. On Linux systems, you can use package managers like apt or yum. On Windows, using XAMPP will handle this for you automatically.

After installation, check that PHP is working by running:

php -v

If you see a version number instead of an error, you're good to go. But don’t stop there — make sure to configure php.ini properly. This file controls things like error reporting, upload sizes, and extensions.

Common settings to tweak:

• display_errors = On (great for development)
• upload_max_filesize and post_max_size if you’re dealing with file uploads
• Enable extensions like mysqli, curl, and mbstring depending on your project needs

Also, remember to restart your server after making changes to php.ini.

Setting Up a Local Server and Testing Environment

Now that PHP is installed, you need somewhere to run your code. XAMPP or MAMP typically installs Apache, so you can drop your PHP files into the htdocs folder and access them via http://localhost.

For better organization, consider virtual hosts. That way, instead of typing http://localhost/myproject, you can set up something like http://myproject.local.

Here's how:

1. Edit the Apache httpd-vhosts.conf file
2. Add a new <virtualhost></virtualhost> block pointing to your project directory
3. Update your system’s hosts file to point the domain to 127.0.0.1
4. Restart Apache

This setup mimics a real-world domain structure and helps when managing multiple projects.

Debugging and Tools You Should Know

No PHP dev environment is complete without some debugging tools. At minimum, you should be logging errors and viewing them — either through the browser or the Apache error log.

Useful tools:

• Xdebug – Adds stack traces, breakpoints, and profiling
• PHPStan or Psalm – Static analysis tools for catching bugs early
• Composer – Essential for dependency management and autoloading

And don’t forget about version control. Always keep your code in Git, even locally. It helps track changes and collaborate better later on.

That's basically it. Once you've got these pieces in place — a solid stack, working PHP install, configured local server, and basic tooling — you’re ready to build just about anything. The key is not to overcomplicate it at first. Get it running, then improve as needed.

The above is the detailed content of From installation to operation: A complete guide to PHP development environments. For more information, please follow other related articles on the PHP Chinese website!