Skip to content

Commit 49e7c30

Browse files
committed
Update PHP Windows instructions
1 parent 2e23678 commit 49e7c30

File tree

6 files changed

+89
-51
lines changed

6 files changed

+89
-51
lines changed
21.9 KB
Loading
12.8 KB
Loading
19.4 KB
Loading
19.8 KB
Loading

docs/.vuepress/routes.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,5 +26,8 @@
2626
"/els-for-languages/php/#rpm-based-systems": "/els-for-languages/php/#installation-instructions-for-linux",
2727
"/els-for-languages/php/#deb-based-systems": "/els-for-languages/php/#installation-instructions-for-linux",
2828
"/els-for-languages/php/#introduction": "/els-for-languages/php/#oval-data",
29-
"/extended-lifecycle-support": "/els-for-os/"
29+
"/extended-lifecycle-support": "/els-for-os/",
30+
"/els-for-languages/php/#download-tuxcare-php-windows": "/els-for-languages/php/#download-and-install-tuxcare-php-windows",
31+
"/els-for-languages/php/#configure-php": "/els-for-languages/php/#download-and-install-tuxcare-php-windows",
32+
"/els-for-languages/php/#add-php-to-the-system-path": "/els-for-languages/php/#download-and-install-tuxcare-php-windows"
3033
}

docs/els-for-languages/php/README.md

Lines changed: 85 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -157,24 +157,88 @@ Each version of PHP can be installed individually or all versions at once.
157157
1. Obtain the required license to get access to the service.
158158
2. Contact [[email protected]](mailto:[email protected]) to receive instructions for generating your unique access link (tokenized URL). Anonymous access is restricted.
159159

160-
### Download TuxCare PHP Windows
160+
### Download and Install TuxCare PHP Windows
161+
162+
TuxCare provides a Windows Installer that allows you to install and manage ELS PHP versions.
161163

162164
1. Follow the instructions provided by [[email protected]](mailto:[email protected]) to create your secure download link.
163-
2. Use this link to download the latest version of PHP.
164-
3. Extract the downloaded archive (ZIP file) to a preferred directory, for example`C:\PHP`.
165-
4. PHP doesn't have a traditional "installer" on Windows, it’s a portable application. Once you extract the files and set up a few things, it's ready to use.
165+
2. Use this link to download the latest version of the PHP installer.
166+
3. Launch the installer. After the first run, it will appear under **Settings > Apps**.
167+
4. Provide you access credentials:
168+
* **Register** - if this is your first time using the installer or you're installing on a new system, choose the "Register" option. You’ll be asked to provide your license key or authentication token. You can also save your token for future use.
169+
170+
![image](/images/php-installer-token.png)
171+
172+
* **Use previous token** - if you’ve already registered on this machine and chose to save your credentials, the installer will detect and use the saved token automatically. You won’t need to enter your credentials again unless the token is missing or expired.
173+
174+
5. Select a PHP version and tick the checkbox next to it. **Only 1 version can be installed per installation**.
175+
176+
![image](/images/php-installer-version.png)
177+
178+
:::tip
179+
If you already have a version installed, it will appear highlighted in green. When another version is selected, the installer will ask whether to **replace** the existing one or install it **alongside**.
180+
181+
![image](/images/php-installer-versions-2.png)
182+
:::
183+
184+
6. Choose Installation Path. By default, the installer will use `C:\Program Files`. Click **Change** if you want to install to a different location.
185+
7. Click **Load** to fetch the required PHP archive. Once the archive is loaded, a list of available PHP modules will appear. Select the modules you need and click **Continue** to confirm.
186+
187+
![image](/images/php-installer-load.png)
188+
189+
8. During installation, the installer will create a folder with PHP configuration and selected modules, and add TuxCare PHP to the **System PATH** (advanced settings).
190+
191+
<details>
192+
<summary>Click to see more</summary>
193+
194+
1. Right-click **This PC** and select **Properties**, or search for **Settings > System > About** in the Start menu.
195+
2. Click **Advanced system settings**.
196+
197+
![image](/images/php-windows-advanced-settings.png)
198+
199+
3. Click on **Environment Variables**.
200+
201+
![image](/images/php-windows-environment-variables.png)
202+
203+
4. Under *System variables*, find **Path** and click **Edit**.
204+
205+
![image](/images/php-windows-add-path.png)
206+
207+
5. You will see your PHP `C:\PHP` directory added.
208+
209+
![image](/images/php-windows-add-path-2.png)
210+
</details>
211+
212+
9. Wait for the installation process to complete.
213+
214+
### Validate the Installation
215+
216+
To confirm PHP is working:
217+
218+
1. Open **Command Prompt**, **PowerShell**, or **Terminal**.
219+
2. Run the following command:
220+
221+
<CodeWithCopy>
222+
223+
```text
224+
php -v
225+
```
166226
167-
### Configure PHP
227+
</CodeWithCopy>
168228
169-
Configure TuxCare ELS PHP for Windows to work as intended on Windows:
229+
You should see output like this:
170230
171-
1. Navigate to your PHP directory (e.g. `C:\PHP`).
172-
2. Find and rename the `php.ini-development` file to `php.ini`. This is the main configuration file PHP uses when running.
231+
```text
232+
PHP 5.6.40 (cli) (built: May 30 2025 15:43:43)
233+
Copyright (c) 1997-2016 The PHP Group
234+
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies
235+
```
173236
174237
### Additional configurations (optional)
175238
176239
Depending on your ELS PHP usage purpose, additional configurations may be required. Here are some commonly useful configurations.
177240
241+
<!--
178242
### Extensions
179243
180244
Many PHP features come as extensions and are disabled by default to keep PHP lightweight. TuxCare provides the required `.dll` files to support these extensions.
@@ -194,8 +258,8 @@ To enable the functionality you need, update the `php.ini` file:
194258
```
195259
196260
</CodeWithCopy>
197-
198-
### Increase Upload/Memory Limits
261+
-->
262+
#### Increase Upload/Memory Limits
199263
200264
If you're integrating PHP with applications like WordPress, you might need to increase memory and upload size limits:
201265
@@ -212,56 +276,27 @@ If you're integrating PHP with applications like WordPress, you might need to in
212276
213277
</CodeWithCopy>
214278
215-
### Add PHP to the System Path
216-
217-
Adding PHP to the system PATH lets you run the `php` command from a terminal window without typing its full location. This is useful for running scripts and using PHP with other tools.
218-
219-
1. Right-click **This PC** and select **Properties**, or search for **Settings > System > About** in the Start menu.
220-
2. Click **Advanced system settings**.
221-
222-
![image](/images/php-windows-advanced-settings.png)
223-
224-
3. Click on **Environment Variables**.
225-
226-
![image](/images/php-windows-environment-variables.png)
227-
228-
4. Under *System variables*, find **Path** and click **Edit**.
229-
230-
![image](/images/php-windows-add-path.png)
231-
232-
5. Click **New** and add your PHP `C:\PHP` directory.
233-
234-
![image](/images/php-windows-add-path-2.png)
279+
#### Example Use Cases
235280
236-
6. Click **OK** to save the changes.
281+
You can integrate PHP with other tools, for example, IIS or WordPress. For further details and documentation, refer to the [official PHP documentation](https://www.php.net/manual/en/index.php).
237282
238-
### Validate the Installation
283+
### Uninstallation
239284
240-
To confirm PHP is working:
285+
#### Uninstall a PHP version,
241286
242-
1. Open **Command Prompt**, **PowerShell**, or **Terminal**.
243-
2. Run the following command:
287+
To uninstall a PHP version:
244288
245-
<CodeWithCopy>
289+
1. Manually delete the PHP installation directory (e.g., `C:\Program Files\TuxCare\php-version`).
246290
247-
```text
248-
php -v
249-
```
291+
2. Remove the PHP path from **System Path**.
250292
251-
</CodeWithCopy>
293+
#### Uninstall TuxCare Installer
252294
253-
You should see output like:
295+
To uninstall TuxCare Installer:
254296
255-
```text
256-
PHP 7.4.33 (cli) (built: Mar 14 2025 04:59:07) ( NTS Visual C++ 2017 x64 )
257-
Copyright (c) The PHP Group
258-
Zend Engine v3.4.0, Copyright (c) Zend Technologies
259-
```
260-
261-
### Example Use Cases
262-
263-
You can integrate PHP with other tools, for example, IIS or WordPress. For further details and documentation, refer to the [official PHP documentation](https://www.php.net/manual/en/index.php).
297+
1. Open **Settings > Apps**.
264298
299+
2. Find *TuxCare Installer* and click **Uninstall** to remove it from the list of installed apps.
265300
266301
## OVAL data
267302

0 commit comments

Comments
 (0)