Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 55 additions & 3 deletions docs/book/v1/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand All @@ -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>/`).
Expand Down
10 changes: 3 additions & 7 deletions wsl/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.

Expand Down
66 changes: 61 additions & 5 deletions wsl/os/almalinux9/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand All @@ -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>/`).
Expand All @@ -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:

Expand All @@ -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`.