Merge pull request #298643 from cdpark/refresh-appservice-batch3

User Story 419632: Q&M: Freshness - Azure App Service - Apr - batch 3

Author: v-regandowner

articles/app-service/configure-language-php.md

@@ -3,36 +3,38 @@ title: Configure a PHP App
 description: Learn how to configure a PHP app in a prebuilt PHP container in Azure App Service. This article shows the most common configuration tasks.
 ms.devlang: php
 ms.topic: how-to
-ms.date: 04/01/2025
+ms.date: 04/22/2025
 ms.custom: devx-track-azurecli, linux-related-content
 zone_pivot_groups: app-service-platform-windows-linux
 ms.author: msangapu
 author: msangapu-msft
 #customer intent: As an app developer who uses PHP, I want to understand how to configure my PHP web apps in Azure App Service.
 ---
 
-# Configure a PHP app for Azure App Service
+# Configure a PHP app in Azure App Service
 
 ::: zone pivot="platform-windows"  
 
 [!INCLUDE [php-eol-notice](./includes/php-windows-eol-notice.md)]
 
-This guide shows you how to configure your PHP web apps, mobile back ends, and API apps in Azure App Service.
+This guide shows you how to configure your PHP web apps, mobile back ends, and API apps in Azure App Service. The most common configuration tasks are covered.
 
-This guide provides key concepts and instructions for PHP developers who deploy apps to App Service. If you're new to App Service, you should first follow the [Create a PHP web app in Azure App Service](quickstart-php.md) quickstart and the [Deploy a PHP, MySQL, and Redis app to Azure App Service](tutorial-php-mysql-app.md) tutorial.
+If you're new to App Service, you should first follow the [Create a PHP web app in Azure App Service](quickstart-php.md) quickstart and the [Deploy a PHP, MySQL, and Redis app to Azure App Service](tutorial-php-mysql-app.md) tutorial.
 
 ## Show the PHP version
 
-To show the current PHP version, run the following command in [Azure Cloud Shell](https://shell.azure.com):
+To show the current PHP version, run the following command. You can use the [Azure Cloud Shell](https://shell.azure.com):
 
 ```azurecli-interactive
 az webapp config show --resource-group <resource-group-name> --name <app-name> --query phpVersion
 ```
 
+Replace `<resource-group-name>` and `<app-name>` with names that are appropriate for your web app.
+
 > [!NOTE]
 > To address a development slot, include the parameter `--slot` followed by the name of the slot.
 
-To show all supported PHP versions, run the following command in Cloud Shell:
+To show all supported PHP versions, run the following command:
 
 ```azurecli-interactive
 az webapp list-runtimes --os windows | grep PHP
@@ -42,22 +44,24 @@ az webapp list-runtimes --os windows | grep PHP
 
 ::: zone pivot="platform-linux"
 
-This guide shows you how to configure your PHP web apps, mobile back ends, and API apps in Azure App Service.
+This guide shows you how to configure your PHP web apps, mobile back ends, and API apps in Azure App Service. The most common configuration tasks are covered.
 
-This guide provides key concepts and instructions for PHP developers who deploy apps to App Service. If you're new to App Service, you should first follow the [Create a PHP web app in Azure App Service](quickstart-php.md) quickstart and the [Deploy a PHP, MySQL, and Redis app to Azure App Service](tutorial-php-mysql-app.md) tutorial.
+If you're new to App Service, you should first follow the [Create a PHP web app in Azure App Service](quickstart-php.md) quickstart and the [Deploy a PHP, MySQL, and Redis app to Azure App Service](tutorial-php-mysql-app.md) tutorial.
 
 ## Show the PHP version
 
-To show the current PHP version, run the following command in [Azure Cloud Shell](https://shell.azure.com):
+To show the current PHP version, run the following command. You can use the [Azure Cloud Shell](https://shell.azure.com).
 
 ```azurecli-interactive
 az webapp config show --resource-group <resource-group-name> --name <app-name> --query linuxFxVersion
 ```
 
+Replace `<resource-group-name>` and `<app-name>` with names that are appropriate for your web app.
+
 > [!NOTE]
 > To address a development slot, include the parameter `--slot` followed by the name of the slot.
 
-To show all supported PHP versions, run the following command in Cloud Shell:
+To show all supported PHP versions, run the following command:
 
 ```azurecli-interactive
 az webapp list-runtimes --os linux | grep PHP
@@ -69,7 +73,7 @@ az webapp list-runtimes --os linux | grep PHP
 
 ::: zone pivot="platform-windows"  
 
-To set the PHP version to 8.1, run the following command in [Cloud Shell](https://shell.azure.com):
+To set the PHP version to 8.1, run the following command:
 
 ```azurecli-interactive
 az webapp config set --resource-group <resource-group-name> --name <app-name> --php-version 8.1
@@ -79,7 +83,7 @@ az webapp config set --resource-group <resource-group-name> --name <app-name> --
 
 ::: zone pivot="platform-linux"
 
-To set the PHP version to 8.1, run the following command in [Cloud Shell](https://shell.azure.com):
+To set the PHP version to 8.1, run the following command:
 
 ```azurecli-interactive
 az webapp config set --resource-group <resource-group-name> --name <app-name> --linux-fx-version "PHP|8.1"
@@ -232,11 +236,11 @@ az webapp config appsettings set --name <app-name> --resource-group <resource-gr
 
 For other environment variables to customize build automation, see [Oryx configuration](https://github.com/microsoft/Oryx/blob/master/doc/configuration.md).
 
-For more information on how App Service runs and builds PHP apps in Linux, see the [Oryx documentation on how PHP apps are detected and built](https://github.com/microsoft/Oryx/blob/master/doc/runtimes/php.md).
+To learn how App Service runs and builds PHP apps in Linux, see the [Oryx documentation on how PHP apps are detected and built](https://github.com/microsoft/Oryx/blob/master/doc/runtimes/php.md).
 
 ## Customize startup
 
-You can run a custom command at the container startup time. Run the following command in [Cloud Shell](https://shell.azure.com):
+You can run a custom command at the container startup time. Run the following command:
 
 ```azurecli-interactive
 az webapp config set --resource-group <resource-group-name> --name <app-name> --startup-file "<custom-command>"
@@ -272,7 +276,7 @@ By default, Azure App Service points the root virtual application path (`/`) to
 
 The web framework of your choice might use a subdirectory as the site root. For example, [Laravel](https://laravel.com/) uses the `public/` subdirectory as the site root.
 
-The default PHP image for App Service uses NGINX, and you change the site root by [configuring the NGINX server with the `root` directive](https://docs.nginx.com/nginx/admin-guide/web-server/serving-static-content/). [This example configuration file](https://github.com/Azure-Samples/laravel-tasks/blob/main/default) contains the following snippet that changes the `root` directive:
+The default PHP image for App Service uses NGINX, and you change the site root by [configuring the NGINX server with the `root` directive](https://docs.nginx.com/nginx/admin-guide/web-server/serving-static-content/). This [example configuration file](https://github.com/Azure-Samples/laravel-tasks/blob/main/default) contains the following snippet that changes the `root` directive:
 
 ```output
 server {
@@ -343,15 +347,15 @@ As an alternative to using a `.user.ini` file, you can use [`ini_set()`](https:/
 
 ::: zone pivot="platform-linux"
 
-To customize `PHP_INI_USER`, `PHP_INI_PERDIR`, and `PHP_INI_ALL` directives for Linux web apps, such as `upload_max_filesize` and `expose_php`, use a custom .ini file. You can create it in an [SSH session](configure-linux-open-ssh-session.md). First, set up the directory:
+To customize `PHP_INI_USER`, `PHP_INI_PERDIR`, and `PHP_INI_ALL` directives for Linux web apps, such as `upload_max_filesize` and `expose_php`, use a custom *.ini* file. You can create it in an [SSH session](configure-linux-open-ssh-session.md). First, set up the directory:
 
-1. Go to your Kudu site, by default: `https://<app-name>-<random-hash>.scm.<region>.azurewebsites.net/`. To get the random hash and region values, in your app **Overview**, copy **Default domain**.
+1. Go to your Kudu site. To get the random hash and region values, in your app **Overview**, copy **Default domain**.
 1. On the top menu, select **Debug console**, then **Bash** or **SSH**.
 1. In Bash or SSH, go to your `/home/site/wwwroot` directory.
 1. Create a directory called `ini` (for example, `mkdir ini`).
 1. Change the current working directory to the `ini` folder that you created.
 
-Next, create an .ini file where you add your settings. This example uses `extensions.ini`. There are no file editors such as Vi, Vim, or Nano, so use Echo to add the settings to the file. Change the `upload_max_filesize` value from `2M` to `50M`. Use the following command to add the setting and create an `extensions.ini` file if one doesn't already exist:
+Next, create an *.ini* file where you add your settings. This example uses `extensions.ini`. There are no file editors such as Vi, Vim, or Nano, so use `Echo` to add the settings to the file. Change the `upload_max_filesize` value from `2M` to `50M`. Use the following command to add the setting and create an `extensions.ini` file if one doesn't already exist:
 
 ```bash
 /home/site/wwwroot/ini>echo "upload_max_filesize=50M" >> extensions.ini
@@ -366,7 +370,7 @@ In the Azure portal, add an application setting to scan the `ini` directory that
 
 1. Go to the [Azure portal](https://portal.azure.com) and select your App Service Linux PHP application.
 1. Go to **Settings** > **Environment variables**.
-1. Select **Add**.
+1. Select **+ Add**.
 1. For **Name** enter *PHP_INI_SCAN_DIR* and for **Value**, enter `:/home/site/wwwroot/ini`.
 1. Select **Apply**, then **Apply** again. Confirm your changes.
 
@@ -381,15 +385,15 @@ In the Azure portal, add an application setting to scan the `ini` directory that
 
 To customize `PHP_INI_SYSTEM` directives, use the `PHP_INI_SCAN_DIR` app setting.
 
-First, run the following command in [Cloud Shell](https://shell.azure.com) to add an app setting called `PHP_INI_SCAN_DIR`:
+First, run the following command to add an app setting called `PHP_INI_SCAN_DIR`:
 
 ```azurecli-interactive
 az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings PHP_INI_SCAN_DIR="d:\home\site\ini"
 ```
 
-Go to the Kudu console (`https://<app-name>-<random-hash>.scm.<region>.azurewebsites.net/DebugConsole`), and then go to `d:\home\site`.
+In the Azure portal, select your app. Under **Development Tools** in the sidebar menu, select **Advanced Tools**, and then go to `d:\home\site` using SSH.
 
-Create a directory in `d:\home\site` called `ini`. Then, create an .ini file in the `d:\home\site\ini` directory, for example, `settings.ini`, with the directives that you want to customize. Use the same syntax that you would use in a `php.ini` file.
+Create a directory in `d:\home\site` called `ini`. Then, create an *.ini* file in the `d:\home\site\ini` directory, for example, `settings.ini`, with the directives that you want to customize. Use the same syntax that you would use in a `php.ini` file.
 
 For example, to change the value of [`expose_php`](https://php.net/manual/ini.core.php#ini.expose-php), run the following commands:
 
@@ -405,19 +409,19 @@ For the changes to take effect, restart the app.
 
 ::: zone pivot="platform-linux"
 
-To customize `PHP_INI_SYSTEM` directives, you can't use the `.htaccess` approach. App Service provides a separate mechanism that uses the `PHP_INI_SCAN_DIR` app setting.
+To customize `PHP_INI_SYSTEM` directives, you can't use the *.htaccess* approach. App Service provides a separate mechanism that uses the `PHP_INI_SCAN_DIR` app setting.
 
-First, run the following command in [Cloud Shell](https://shell.azure.com) to add an app setting called `PHP_INI_SCAN_DIR`:
+First, run the following command to add an app setting called `PHP_INI_SCAN_DIR`:
 
 ```azurecli-interactive
 az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings PHP_INI_SCAN_DIR="/usr/local/etc/php/conf.d:/home/site/ini"
 ```
 
-The value `/usr/local/etc/php/conf.d` is the default directory where `php.ini` exists. The value `/home/site/ini` is the custom directory in which you add a custom .ini file. You separate the values with a colon (`:`).
+The value `/usr/local/etc/php/conf.d` is the default directory where `php.ini` exists. The value `/home/site/ini` is the custom directory in which you add a custom *.ini* file. You separate the values with a colon (`:`).
 
-Go to the web SSH session with your Linux container (`https://<app-name>-<random-hash>.scm.<region>.azurewebsites.net/webssh/host`).
+Go to the web SSH session with your Linux container.
 
-Create a directory in `/home/site` called `ini`. Then, create an .ini file in the `/home/site/ini` directory, for example, `settings.ini`, with the directives that you want to customize. Use the same syntax that you would use in a `php.ini` file.
+Create a directory in `/home/site` called `ini`. Then, create an *.ini* file in the `/home/site/ini` directory, for example, `settings.ini`, with the directives that you want to customize. Use the same syntax that you would use in a `php.ini` file.
 
 > [!TIP]
 > The built-in Linux containers in App Service use `/home` as persisted shared storage.
@@ -445,7 +449,7 @@ The built-in PHP installations contain the most commonly used extensions. You ca
 
 To enable other extensions, use the following steps:
 
-1. Add a `bin` directory to the root directory of your app, and put the `.dll` extension files in it, for example, `mongodb.dll`. Make sure that the extensions are compatible with the PHP version in Azure, and that they're VC9 and non-thread-safe (NTS) compatible.
+1. Add a `bin` directory to the root directory of your app, and put the *.dll* extension files in it, for example, `mongodb.dll`. Make sure that the extensions are compatible with the PHP version in Azure, and that they're VC9 and non-thread-safe (NTS) compatible.
 
 1. Deploy your changes.
 
@@ -469,7 +473,7 @@ The built-in PHP installations contain the most commonly used extensions. You ca
 
 To enable other extensions, use the following steps:
 
-1. Add a `bin` directory to the root directory of your app, and put the `.so` extension files in it (for example, `mongodb.so`). Make sure that the extensions are compatible with the PHP version in Azure, and that they're VC9 and non-thread-safe (NTS) compatible.
+1. Add a `bin` directory to the root directory of your app, and put the *.so* extension files in it (for example, `mongodb.so`). Make sure that the extensions are compatible with the PHP version in Azure, and that they're VC9 and non-thread-safe (NTS) compatible.
 
 1. Deploy your changes.
 
@@ -504,7 +508,7 @@ Use the standard [`error_log()`](https://php.net/manual/function.error-log.php)
 
 When a working PHP app behaves differently in App Service or has errors, try the following solutions:
 
-- [Access the log stream](#access-diagnostic-logs).
+- Access the [diagnostic log stream](#access-diagnostic-logs).
 - Test the app locally in production mode. App Service runs your app in production mode, so you need to make sure that your project works as expected in production mode locally. For example:
   - Depending on your `composer.json` file, different packages might be installed for production mode (`require` versus `require-dev`).
   - Certain web frameworks might deploy static files differently in production mode.