Updates

Author: madeline-underwood

content/learning-paths/servers-and-cloud-computing/php-on-gcp/background.md

@@ -1,5 +1,5 @@
 ---
-title: Deploy PHP on Google Cloud Axion C4A Arm VMs
+title: Get started with PHP on Google Axion C4A on Arm Neoverse V2
 
 weight: 2
 
@@ -16,6 +16,14 @@ For more information on Google Axion, see [Introducing Google Axion Processors,
 
 ## PHP
 
-PHP (Hypertext Preprocessor) is an open-source, server-side scripting language designed for web development. It allows you  to create dynamic web pages, interact with databases, handle forms, and build web applications. You can embed PHP directly into HTML, making it easy to generate content dynamically on the server before sending it to the browser.  
+PHP (Hypertext Preprocessor) is an open-source, server-side scripting language designed for web development. You use PHP to:
+- Create dynamic web pages
+- Interact with databases
+- Handle forms
+- Build web applications and APIs
+
+You can embed PHP directly into HTML, making it easy to generate content dynamically on the server before sending it to the browser.
 
 PHP is widely used for websites, web applications, content management systems (CMS), and APIs. For more information, see the [PHP website](https://www.php.net/) and the [PHP documentation](https://www.php.net/docs.php).
+
+You’re ready to begin deploying PHP workloads on Arm-based Google Cloud Axion C4A VMs. This Learning Path helps you optimize PHP for Arm servers, benchmark performance, and migrate from x86 to Arm with confidence.

content/learning-paths/servers-and-cloud-computing/php-on-gcp/baseline.md

@@ -1,5 +1,5 @@
 ---
-title: PHP baseline testing on Google Axion C4A Arm Virtual Machine
+title: Validate PHP baseline on Google Cloud Axion C4A Arm VM
 weight: 5
 
 ### FIXED, DO NOT MODIFY
@@ -8,14 +8,13 @@ layout: learningpathall
 
 
 ## Baseline Setup for PHP-FPM
-This section guides you through configuring PHP-FPM (FastCGI Process Manager) on a SUSE Arm-based Google Cloud C4A virtual machine. You will prepare the PHP-FPM pool configuration, verify PHP's FastCGI setup, and later connect it to Apache to confirm end-to-end functionality.
+In this section, you’ll configure PHP-FPM (FastCGI Process Manager) on a SUSE Linux Arm-based Google Cloud Axion C4A virtual machine. You’ll set up the PHP-FPM pool, verify FastCGI configuration, connect PHP-FPM to Apache, and confirm that your Arm server is ready for dynamic PHP workloads.
 
 ### Configure the PHP-FPM Pool
 
-PHP-FPM (FastCGI Process Manager) runs PHP scripts in dedicated worker processes that are independent of the web server.
-This design improves performance, security, and fault isolation — especially useful on multi-core Arm-based processors like Google Cloud’s Axion C4A VMs.
+PHP-FPM (FastCGI Process Manager) runs PHP scripts in dedicated worker processes, independent of the web server. This design improves performance, security, and fault isolation—especially on multi-core Arm-based processors like Google Cloud Axion C4A VMs.
 
-A pool defines a group of PHP worker processes, each serving incoming FastCGI requests. Different applications or virtual hosts can use separate pools for better resource control.
+A pool is a group of PHP worker processes that serve FastCGI requests. You can use separate pools for different applications or virtual hosts to control resources more effectively.
 
 ### Copy the Default Configuration (if missing)
 
@@ -26,8 +25,8 @@ sudo cp /etc/php8/fpm/php-fpm.d/www.conf.default /etc/php8/fpm/php-fpm.d/www.con
 sudo cp /etc/php8/fpm/php-fpm.conf.default /etc/php8/fpm/php-fpm.conf
 ```
 These commands:
-Create a default pool configuration (www.conf) that controls how PHP-FPM spawns and manages worker processes.
-Restore the main FPM service configuration (php-fpm.conf) if it's missing.
+- Create a default pool configuration (`www.conf`) to control how PHP-FPM spawns and manages worker processes.
+- Restore the main FPM service configuration (`php-fpm.conf`) if it’s missing.
 
 ### Edit the Configuration
 
@@ -91,11 +90,11 @@ You should see output similar to:
 Oct 16 13:56:44 pareena-php-test systemd[1]: Starting The PHP FastCGI Process Manager...
 Oct 16 13:56:44 pareena-php-test systemd[1]: Started The PHP FastCGI Process Manager.
 ```
-PHP-FPM is now active and ready to process requests via its Unix socket (/run/php-fpm/www.sock).
-Next, you will configure Apache to communicate with PHP-FPM, allowing your server to process and serve dynamic PHP pages.
+PHP-FPM is now active and ready to process requests via its Unix socket (`/run/php-fpm/www.sock`).
+Next, you’ll configure Apache to communicate with PHP-FPM, allowing your Arm server to process and serve dynamic PHP pages.
 
 ## Install the Apache PHP8 module
-If you prefer to have Apache handle PHP execution directly (instead of using PHP-FPM), you can install the Apache PHP 8 module, which integrates PHP into Apache using the `mod_php` interface:
+If you want Apache to handle PHP execution directly (instead of using PHP-FPM), install the Apache PHP 8 module, which integrates PHP into Apache using the `mod_php` interface:
 
 ```console
 sudo zypper install apache2-mod_php8
@@ -105,27 +104,27 @@ Once the module is installed, restart Apache to load the new configuration:
 ```console
 sudo systemctl restart apache2
 ```
-Next, you will test PHP execution by creating a simple PHP page and verifying that Apache can correctly render dynamic content.
+Next, you’ll test PHP execution by creating a simple PHP page and verifying that Apache can correctly render dynamic content.
 
 ## Test PHP
-Now that PHP and Apache are installed, you can verify that everything is working correctly.
+Now that PHP and Apache are installed, you can verify that everything is working correctly on your Arm-based VM.
 
 ### Create a Test Page
 Create a simple PHP file that displays detailed information about your PHP installation:
 
 ```console
 echo "<?php phpinfo(); ?>" | sudo tee /srv/www/htdocs/info.php
 ```
-This creates a file named `info.php` inside Apache's web root directory `(/srv/www/htdocs/)`. When you open this file in a browser, it will display the PHP configuration page.
+This creates a file named `info.php` inside Apache’s web root directory (`/srv/www/htdocs/`). When you open this file in a browser, it displays the PHP configuration page.
 
 ### Test from Inside the VM
 You can verify that PHP and Apache are communicating correctly by testing the web server locally using curl:
 
 ```console
 curl http://localhost/info.php
 ```
-- `curl` fetches the page from the local Apache server.  
-- If PHP is working, you will see a large block of HTML code as output. This is the rendered output of the phpinfo() function.
+- `curl` fetches the page from the local Apache server.
+- If PHP is working, you’ll see a large block of HTML code as output. This is the rendered output of the `phpinfo()` function.
 - This confirms that Apache successfully passed the request to the PHP interpreter and returned the generated HTML response.
 
 You should see output similar to:
@@ -148,20 +147,21 @@ h1 {font-size: 150%;}
 h2 {font-size: 125%;}
 h2 a:link, h2 a:visited{color: inherit; background: inherit;}
 ```
-This long HTML output represents the PHP configuration page content. 
+This long HTML output represents the PHP configuration page content.
 
 ### Test from Your Browser
-Now, let's verify that your PHP setup works correctly from outside the VM.
+Now, verify that your PHP setup works correctly from outside the VM.
 Open a web browser on your local machine (such as Chrome, Firefox, or Edge) and enter the following URL in the address bar:
 
 ```console
 http://<YOUR_VM_PUBLIC_IP>/info.php
 ```
-- Replace `<YOUR_VM_PUBLIC_IP>` with the public IP of your Google Cloud Axion VM.
+- Replace `<YOUR_VM_PUBLIC_IP>` with the public IP of your Google Cloud Axion C4A Arm VM.
 
-If everything is set up correctly, you will see a PHP Info page in your browser. It looks like this:
+If everything is set up correctly, you’ll see a PHP Info page in your browser. It looks like this:
 
 ![PHP-info page alt-text#center](images/php-web.png "Figure 1: PHP info")
 
-Successfully loading the PHP Info page in your browser confirms that your PHP and Apache environment on Google Cloud C4A is configured and functioning properly.
-You are now ready to proceed to the benchmarking and performance testing phase.
+Successfully loading the PHP Info page in your browser confirms that your PHP and Apache environment on Google Cloud Axion C4A Arm is configured and functioning properly.
+
+You’ve validated your PHP baseline setup on an Arm-based Google Cloud VM. You’re ready to move on to benchmarking and performance testing for your PHP workloads on Arm.