Easy PHP Installation: Complete Step-by-Step Setup Guide
Master your local PHP installation on Windows, macOS, or Linux using XAMPP and Homebrew. Learn how to configure server paths and troubleshoot setup errors easily.
Overview: Local PHP Installation Steps
Quick PHP Installation Checklist:
- Windows: Download XAMPP, run the installer, and add
C:\xampp\phpto your System PATH environment variables. - macOS: Launch Terminal and execute
brew install phpvia Homebrew. - Linux (Ubuntu): Open Terminal and execute
sudo apt install php php-cli php-mysql. - Verification: Run
php -vin your command line or execute aphpinfo();script locally.
Welcome to our hands-on guide to completing your local PHP installation. Before you can write and execute backend scripts on your machine, you must configure a web server environment equipped with the PHP interpreter engine, a web server (like Apache or Nginx), and a relational database manager.
A proper PHP installation ensures that your local environment behaves identically to a live production server, eliminating script execution failures and path configuration errors early in your learning process.
Prerequisites Before Starting Your PHP Installation
Before proceeding with your local PHP installation, ensure you have the following requirements ready on your operating system:
- Administrator Privileges: Permission to install packages and modify system environment variable paths.
- Code Editor / IDE: Visual Studio Code, PhpStorm, or Sublime Text.
If you need a refresher on basic concepts before completing your setup, start with our Best PHP Tutorial for Beginners.
Windows Setup: PHP Installation Using XAMPP
For Windows developers, the simplest method for completing a PHP installation is using XAMPP, an all-in-one software package containing Apache, MySQL, and PHP.
1. Download and Run the Installer
Download the latest version of XAMPP (featuring PHP 8.x) from Apache Friends. Launch the setup wizard, ensuring both Apache and MySQL remain selected.
2. Configure System PATH Environment Variables
To run php commands globally in Command Prompt or PowerShell, you must link the execution path after your PHP installation:
- Open Windows Search and type “Environment Variables”.
- Click “Edit the system environment variables” and select Environment Variables….
- In the System variables section, locate
Pathand click Edit. - Click New, type
C:\xampp\php, and click OK to save your path configuration.
macOS & Linux: PHP Installation Commands
For Mac users, completing a terminal-based PHP installation using Homebrew is fast and straightforward:
# Update local Homebrew formulae
brew update
# Perform PHP installation
brew install php
# Verify current installed version
php -vFor Ubuntu or Debian Linux distributions, run the following command in your terminal:
sudo apt update && sudo apt install php php-cli php-fpm php-mysql -yVerifying Your Installation Success
Once your local PHP installation is finished, verify that your server engine processes script tags correctly by creating a test file named info.php inside your public server root (e.g., C:\xampp\htdocs\ or /var/www/html/):
<?php
// Script to test local PHP installation status
phpinfo();
?>Open your browser and navigate to http://localhost/info.php. If a configuration page displays active extensions and version numbers, your setup is complete!
Troubleshooting Common Installation Errors
If you encounter errors after setting up your environment, use this troubleshooting guide to resolve common configuration issues:
| Observed Issue | Root Cause | Recommended Resolution |
|---|---|---|
'php' is not recognized as an internal or external command | System PATH variable was not configured during installation. | Add C:\xampp\php to your System PATH variables and restart Command Prompt/PowerShell. |
| Apache Server fails to start (Port 80 conflict) | Another background service (like Skype or IIS) is using Port 80. | Change the Apache port in httpd.conf to 8080 or stop conflicting applications. |
| Browser prints raw code instead of processing script | Web server is missing module association for .php files. | Confirm Apache PHP modules are active and ensure your file extension ends in .php rather than .html. |
Frequently Asked Questions (FAQ)
Q1: Which method is easiest for a local PHP installation?
For Windows users, installing XAMPP provides the easiest PHP installation experience. On macOS, running brew install php via Homebrew is the most reliable method.
Q2: Can I install multiple PHP versions on the same machine?
Yes. Using containerization tools like Docker or version switching tools like Homebrew (macOS) or Laragon (Windows) allows you to manage multiple concurrent PHP environments easily.
Q3: Should I remove the info.php file after testing my server?
Yes! While safe locally, leaving a phpinfo() script on a live production web server exposes sensitive environment configurations to potential security threats.
Next Steps & Official Documentation
For advanced source compilation and manual setup options, visit the PHP Official Installation Documentation (php.net).
Ready to start writing code? Proceed to the next tutorial in our series: Next Lesson: PHP Syntax, Variables & Scope →
# Summary
Here is what you've learned in this lesson:
- Overview: Local PHP Installation Steps
- Prerequisites Before Starting Your PHP Installation
- Windows Setup: PHP Installation Using XAMPP
- macOS & Linux: PHP Installation Commands
- Verifying Your Installation Success
- Troubleshooting Common Installation Errors
- Frequently Asked Questions (FAQ)
- Next Steps & Official Documentation
Continue to the next lesson and learn more about PHP Version Guide – Complete Timeline, Features & Compatibility.