Merge pull request #52 from dotkernel/update-phpmyadmin-composer

FAQ: Update `Composer` and `phpMyAdmin`

Author: alexmerlin

docs/book/v1/faq.md

@@ -59,7 +59,7 @@ node -v
 
 ## How do I fix common permission issues?
 
-If running your project you encounter permission issues, follow the below steps.
+If running your project, you encounter permission issues, follow the below steps.
 
 ### Error
 
@@ -100,9 +100,9 @@ chmod -R 777 log
 
 ## Where are the error log files?
 
-From time to time, you are encountering various errors which are not displayed. Or you can get errors 500 in browser.
+From time to time, you are encountering various errors which are not displayed. Or you can get errors 500 in a browser.
 
-In order to find the error messages, you need to read the error log files.
+To find the error messages, you need to read the error log files.
 
 ### Apache log files
 
@@ -117,6 +117,58 @@ In order to find the error messages, you need to read the error log files.
 /var/log/php-fpm/www-error.log
 ```
 
+## How do I update Composer?
+
+Before updating, check your current Composer version by executing:
+
+```shell
+composer --version
+```
+
+The output should be similar to:
+
+```text
+Composer version 2.8.5 2025-01-21 15:23:40
+PHP version 8.3.20 (/usr/bin/php)
+Run the "diagnose" command to get more detailed diagnostics output.
+```
+
+Update Composer using its own `self-update` command:
+
+```shell
+sudo /usr/local/bin/composer self-update
+```
+
+The output should be similar to:
+
+```text
+Upgrading to version 2.8.8 (stable channel).
+
+Use composer self-update --rollback to return to version 2.8.5
+```
+
+After updating, check again your Composer version by executing:
+
+```shell
+composer --version
+```
+
+The output should be similar to:
+
+```text
+Composer version 2.8.8 2025-04-04 16:56:46
+PHP version 8.3.20 (/usr/bin/php)
+Run the "diagnose" command to get more detailed diagnostics output.
+```
+
+## How do I update phpMyAdmin?
+
+Being installed as a system package, it can be updated using the command which updates the rest of the system packages:
+
+```shell
+sudo dnf upgrade -y
+```
+
 ## How do I create command aliases?
 
 From either your terminal or file explorer, navigate to your home directory (`/home/<your-username>/`).

wsl/README.md

@@ -4,12 +4,9 @@
 
 ## Prerequisites
 
-Before proceeding with the installation, please consult Microsoft's
-[documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements
-for running WSL2.
+Before proceeding with the installation, please consult Microsoft's [documentation](https://learn.microsoft.com/en-us/windows/wsl/install#prerequisites) regarding the minimum requirements for running WSL2.
 
-Once you know that your machine can run WSL2, open the `Run` prompt by pressing `Win`+`r` and type in the dialog
-`OptionalFeatures`, then press `Enter`.
+Once you know that your machine can run WSL2, open the `Run` prompt by pressing `Win`+`r` and type in the dialog `OptionalFeatures`, then press `Enter`.
 
 This will open a window where you can turn Windows features on/off.
 
@@ -19,8 +16,7 @@ Make sure the next features are activated (checked):
 - `Virtual Machine Platform`
 - `Windows Subsystem for Linux`
 
-> If any of the above features is missing, then first you need to install them manually using
-> [this guide](https://docs.microsoft.com/en-us/windows/wsl/install-manual) and then continue with the below steps.
+> If any of the above features are missing, then first you need to install them manually using [this guide](https://docs.microsoft.com/en-us/windows/wsl/install-manual) and then continue with the below steps.
 
 Click `Ok` and restart your computer.
 

wsl/os/almalinux9/FAQ.md

@@ -59,7 +59,7 @@ node -v
 
 ## How do I fix common permission issues?
 
-If running your project you encounter permission issues, follow the below steps.
+If running your project, you encounter permission issues, follow the below steps.
 
 ### Error
 
@@ -100,9 +100,9 @@ chmod -R 777 log
 
 ## Where are the error log files?
 
-From time to time, you are encountering various errors which are not displayed. Or you can get errors 500 in browser.
+From time to time, you are encountering various errors which are not displayed. Or you can get errors 500 in a browser.
 
-In order to find the error messages, you need to read the error log files.
+To find the error messages, you need to read the error log files.
 
 ### Apache log files
 
@@ -117,6 +117,58 @@ In order to find the error messages, you need to read the error log files.
 /var/log/php-fpm/www-error.log
 ```
 
+## How do I update Composer?
+
+Before updating, check your current Composer version by executing:
+
+```shell
+composer --version
+```
+
+The output should be similar to:
+
+```text
+Composer version 2.8.5 2025-01-21 15:23:40
+PHP version 8.3.20 (/usr/bin/php)
+Run the "diagnose" command to get more detailed diagnostics output.
+```
+
+Update Composer using its own `self-update` command:
+
+```shell
+sudo /usr/local/bin/composer self-update
+```
+
+The output should be similar to:
+
+```text
+Upgrading to version 2.8.8 (stable channel).
+
+Use composer self-update --rollback to return to version 2.8.5
+```
+
+After updating, check again your Composer version by executing:
+
+```shell
+composer --version
+```
+
+The output should be similar to:
+
+```text
+Composer version 2.8.8 2025-04-04 16:56:46
+PHP version 8.3.20 (/usr/bin/php)
+Run the "diagnose" command to get more detailed diagnostics output.
+```
+
+## How do I update phpMyAdmin?
+
+Being installed as a system package, it can be updated using the command which updates the rest of the system packages:
+
+```shell
+sudo dnf upgrade -y
+```
+
 ## How do I create command aliases?
 
 From either your terminal or file explorer, navigate to your home directory (`/home/<your-username>/`).
@@ -125,7 +177,9 @@ Using your preferred text editor, open the file: `.bash_profile` (if it does not
 
 Move to the end of the file and enter on a new line:
 
-    alias command_alias="command to execute"
+```text
+alias command_alias="command to execute"
+```
 
 where:
 
@@ -134,6 +188,8 @@ where:
 
 ### Example:
 
-    alias list_files="ls -Al"
+```text
+alias list_files="ls -Al"
+```
 
 will create an alias called `list_files` that will run the command `ls -Al`.