How to install PHP on Windows, Linux, and Mac: A Comprehensive Guide [5 easy steps]

If you are a software developer working on any machine, you may need to install PHP for your project. PHP is a widely-used programming language for web development, and it is a popular choice for building dynamic web applications. This guide will walk you through the step-by-step process of installing PHP.

How to install PHP on Windows

Prerequisites

Before we get started with the installation, there are a few prerequisites that need to be met. First, make sure that your machine is running a supported version of Windows. PHP is compatible with Windows 7, 8, 8.1, and 10. Additionally, you will need to have administrative access to your machine in order to install PHP.

Step 1: Download PHP

The first step in the installation process is to download the PHP installation package. You can download the latest stable version of PHP from the official PHP website at php.net. Make sure to choose the correct package for your version of Windows (32-bit or 64-bit).

Step 2: Extract the Files

Once the download is complete, extract the contents of the ZIP file to a directory on your computer. You can use a program like 7-Zip or WinRAR to extract the files.

Step 3: Configure PHP

Now that you have extracted the files, you need to configure PHP for your machine. Open the extracted PHP directory and locate the php.ini-development file. Rename this file to php.ini.

Next, open the php.ini file using a text editor. You can use Notepad or any other text editor of your choice. Look for the following line in the file:

; extension_dir = "ext"

Remove the semicolon (;) from the beginning of the line to uncomment it. Then, update the path to the extensions directory to match the path on your machine. For example, if you extracted the files to C:\php, the line should look like this:

extension_dir = "C:\php\ext"

Save the changes to the php.ini file and close the text editor.

Step 4: Add PHP to the System Path

In order to use PHP from the command line, you need to add it to the system path. This will allow you to run PHP commands from any directory on your computer.

To add PHP to the system path, follow these steps:

1. Open the Start menu and search for “Environment Variables”.
2. Click on “Edit the system environment variables”.
3. Click on the “Environment Variables” button.
4. Under “System variables”, scroll down and find the “Path” variable. Click on “Edit”.
5. Click on “New” and add the path to your PHP directory (e.g. C:\php).
6. Click “OK” to save the changes.

Step 5: Test the Installation

Now that you have installed and configured PHP on your Windows machine, it’s time to test it to make sure everything is working correctly.

To test PHP, create a new PHP file with the following code:

<?php
phpinfo();
?>

Save the file as test.php and place it in your web server’s document root directory. For example, if you are using Apache, the document root directory is typically located at C:\xampp\htdocs.

Next, open a web browser and navigate to http://localhost/test.php. If everything is configured correctly, you should see a page with detailed information about your PHP installation.

How to install PHP on Linux

Prerequisites

Before we get started with the installation, there are a few prerequisites that need to be met. First, make sure that your Linux distribution is up to date. You can update your system by running the following command:

sudo apt update && sudo apt upgrade

Additionally, you will need to have administrative access to your machine in order to install PHP.

Step 1: Install PHP

The first step in the installation process is to install PHP. You can install PHP and its dependencies by running the following command:

sudo apt install php libapache2-mod-php

This command will install the latest version of PHP and its Apache module on your system.

Step 2: Verify the Installation

Once the installation is complete, you can verify that PHP is installed and working correctly by creating a new PHP file with the following code:

<?php
phpinfo();
?>

Save the file as test.php and place it in your web server’s document root directory. For example, if you are using Apache, the document root directory is typically located at /var/www/html/.

Next, open a web browser and navigate to http://localhost/test.php. If everything is configured correctly, you should see a page with detailed information about your PHP installation.

Step 3: Install Additional PHP Extensions

Depending on your project requirements, you may need to install additional PHP extensions. To install a PHP extension, you can use the following command:

sudo apt install php-<extension-name>

Replace <extension-name> with the name of the extension you want to install. For example, to install the MySQL extension, you would run the following command:

sudo apt install php-mysql

Step 4: Configure PHP

Now that you have installed PHP, you need to configure it for your machine. You can edit the PHP configuration file by running the following command:

sudo nano /etc/php/<version>/apache2/php.ini

Replace <version> with the version of PHP you have installed. For example, if you have installed PHP 8.0, you would run the following command:

sudo nano /etc/php/8.0/apache2/php.ini

In the php.ini file, you can modify the settings for PHP. For example, you can change the maximum upload size by modifying the following line:

upload_max_filesize = 2M

Save the changes to the php.ini file and restart Apache by running the following command:

sudo systemctl restart apache2

Step 5: Test PHP with a Framework

If you are using a PHP framework for your project, it’s a good idea to test PHP with the framework to make sure everything is working correctly. For example, if you are using Laravel, you can create a new Laravel project by running the following command:

composer create-project --prefer-dist laravel/laravel myproject

Using composer we’ve created a new Laravel project in a directory called “myproject”. You can then navigate to the project directory and start the development server by running the following command:

cd myproject

php artisan serve

Next, open a web browser and navigate to http://localhost:8000. You should see the default Laravel home page if everything is configured correctly.

How to install PHP on Mac

Prerequisites

Before we get started with the installation, there are a few prerequisites that need to be met. First, make sure that your Mac is up to date. You can update your system by going to the Apple menu and selecting “Software Update”. Additionally, you will need to have administrative access to your machine in order to install PHP.

Step 1: Install Homebrew

The first step in the installation process is to install Homebrew. Homebrew is a package manager for macOS that makes installing and managing software packages easy. To install Homebrew, open the Terminal app and run the following command:

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

This command will download and install Homebrew on your machine.

Step 2: Install PHP

Once Homebrew is installed, you can use it to install PHP. To install PHP, run the following command:

brew install php

This command will install the latest version of PHP and its dependencies on your system.

Step 3: Verify the Installation

Once the installation is complete, you can verify that PHP is installed and working correctly by creating a new PHP file with the following code:

<?php
phpinfo();
?>

Save the file as test.php and place it in your web server’s document root directory. For example, if you are using Apache, the document root directory is typically located at /Library/WebServer/Documents/.

Next, open a web browser and navigate to http://localhost/test.php. If everything is configured correctly, you should see a page with detailed information about your PHP installation.

Step 4: Install Additional PHP Extensions

Depending on your project requirements, you may need to install additional PHP extensions. To install a PHP extension, you can use the following command:

brew install php-<extension-name>

Replace <extension-name> with the extension name you want to install. To see the entire list of brew extensions you can use the following command:

brew list

For example, to install the MySQL extension, you would run the following command:

brew install php-mysql

Step 5: Configure PHP

Now that you have installed PHP, you need to configure it for your machine. You can edit the PHP configuration file by running the following command:

sudo nano /usr/local/etc/php/<version>/php.ini

Replace <version> with the version of PHP you have installed. For example, if you have installed PHP 8.0, you would run the following command:

sudo nano /usr/local/etc/php/8.0/php.ini

In the php.ini file, you can modify the settings for PHP. For example, you can change the maximum upload size by modifying the following line:

upload_max_filesize = 2M

Save the changes to the php.ini file and restart Apache by running the following command:

sudo apachectl restart

Step 6: Test PHP with a Framework

If you are using a PHP framework for your project, it’s a good idea to test PHP with the framework to make sure everything is working correctly. For example, if you are using Laravel, you can create a new Laravel project by running the following command:

composer create-project --prefer-dist laravel/laravel myproject

This command will create a new Laravel project in a directory called “myproject”. You can then navigate to the project directory and start the development server by running the following command:

cd myproject

php artisan serve

Next, open a web browser and navigate to http://localhost:8000. If everything is configured correctly, you should see the default Laravel home page.

Conclusion

In this guide, we have shown you how to install PHP. Following these steps, you should now have a fully-functional PHP installation on your machine. If you encounter any issues during the installation process, don’t hesitate to consult the official PHP documentation or seek help from the online community.

Remember, PHP is a powerful programming language widely used for web development. Having PHP installed on your computer has opened up a world of possibilities for building dynamic web applications.

You may encounter new challenges and requirements as you continue to work with PHP. Fortunately, the PHP community is large and active, with many resources available to help you. Two trusted sources of information are the official PHP documentation at php.net and the online community at Stack Overflow.

📕 Related articles about PHP

• How to learn PHP programming language
• Understanding PHP Abstract Classes
• PHP Interfaces: Enhancing the Power and Versatility of PHP
• PHP Comments: A Comprehensive Guide
• PHP Traits: The Ultimate Guide to Traits in Object-Oriented Programming
• How to use PHP with WordPress