From 28be140200a2e9755538f7f003f4546bbba3e6f9 Mon Sep 17 00:00:00 2001 From: alexmerlin Date: Mon, 28 Apr 2025 17:46:19 +0300 Subject: [PATCH] FAQ: Update Composer and phpMyAdmin Signed-off-by: alexmerlin --- docs/book/v1/faq.md | 58 +++++++++++++++++++++++++++++++++-- wsl/README.md | 10 ++---- wsl/os/almalinux9/FAQ.md | 66 +++++++++++++++++++++++++++++++++++++--- 3 files changed, 119 insertions(+), 15 deletions(-) diff --git a/docs/book/v1/faq.md b/docs/book/v1/faq.md index 55ffd9c..401794f 100644 --- a/docs/book/v1/faq.md +++ b/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//`). diff --git a/wsl/README.md b/wsl/README.md index b32592e..078158e 100644 --- a/wsl/README.md +++ b/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. diff --git a/wsl/os/almalinux9/FAQ.md b/wsl/os/almalinux9/FAQ.md index 35eefc0..08e3106 100644 --- a/wsl/os/almalinux9/FAQ.md +++ b/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//`). @@ -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`.