Issue #21: Use *.localhost domains instead of *.local

wsl/config.yml

@@ -7,7 +7,7 @@ config:
     root_password: ""
   system:
     username: "{{ lookup('env', 'USER') }}"
-  # Add as many virtualhosts as needed - if a virtualhost already exists, it will not be created
-  # example.local is an example, you can remove it and add your own local domains
+  # Add as many virtualhosts as needed - if a virtualhost already exists, it will be skipped
+  # example.localhost is an example, you can remove it and add your own local domains
   virtualhosts:
-    - "example.local"
+    - "example.localhost"

wsl/os/almalinux9/README.md

@@ -102,44 +102,33 @@ Now check if everything works by opening in your browser:
 The installation is complete, your development environment is ready to use.
 
 
-## Create virtual hosts
+## Create virtualhosts
 Move inside the directory `development/wsl`:
 
     cd ~/development/wsl/
 
-Using your preferred text editor, open `config.yml` and add the hosts that you want to create under the `virtualhosts` list. Save and close the file.
+Using your preferred text editor, open `config.yml` and, under the `virtualhosts` key, enter the virtualhosts that you want to create, each on its own line. 
 
-Create the specified virtual hosts:
+Already existing ones will be skipped, no need to comment or remove them.
 
-    ansible-playbook -i hosts create-virtualhost.yml --ask-become-pass
-
-This will iterate over the list of `virtualhosts` configured in `config.yml` and will output a short summary with the results.
-
-At this step, your virtual host is not yet accessible because first, you need to route the requests to your localhost.
-
-**Run as administrator** any text editor and open file `C:\Windows\System32\drivers\etc\hosts` (if you don't see it, select `All files` from the file type selector).
+Save and close the file.
 
-For each item you placed in the `virtualhosts` list, add the below lines to the end of the file (make sure you replace `{virtualhost}` with your virtual host), then save and close the file.
+Create the specified virtualhosts:
 
-    127.0.0.1	{virtualhost}
-    ::1	{virtualhost}
+    ansible-playbook -i hosts create-virtualhost.yml --ask-become-pass
 
-Example:
+This will iterate over the list of configured `virtualhosts` and will output a short summary with the results.
 
-    127.0.0.1	example.local
-    ::1	example.local
-    127.0.0.1	example2.local
-    ::1	example2.local
+Your virtualhost should be accessible and ready to use.
 
-Your virtual host should be accessible and ready to use.
+You will install your project under the `html` directory of your project, for example: `/var/www/example.localhost/html`.
 
-You will install your project under the `html` directory of your project, for example: `/var/www/example.local/html`.
-The virtualhost's document root is set to the `public` directory of the above location, for example `/var/www/example.local/html/public`.
+The virtualhost's document root is set to the `public` directory of the above location, for example `/var/www/example.localhost/html/public`.
 
 **Note**:
 * In order to run your installed projects, you need to start AlmaLinux 9 first.
 * If you work with virtualhosts, your projects are created under `/var/www/`.
 * You can still run PHP scripts under the default Apache project directory, located at `/var/www/html/`.
 * If you encounter write permission issues, see [this guide](FAQ.md#how-do-i-fix-common-permission-issues).
-* We install PHP 8.1 by default. If you need a different version, see [this guide](FAQ.md#how-do-i-switch-to-a-different-version-of-php).
+* We install PHP 8.2 by default. If you need a different version, see [this guide](FAQ.md#how-do-i-switch-to-a-different-version-of-php).
 * We install NodeJS 18 by default. If you need a different version, see [this guide](FAQ.md#how-do-i-switch-to-a-different-version-of-nodejs).

wsl/os/almalinux9/roles/php/tasks/main.yml

@@ -1,7 +1,7 @@
 ---
-- name: Install PHP 8.1
-  command: dnf module install php:remi-8.1 -y
-- name: Enable and start PHP 8.1
+- name: Install PHP 8.2
+  command: dnf module install php:remi-8.2 -y
+- name: Enable and start PHP 8.2
   command: systemctl enable --now php-fpm
 - name: Create PHP info file
   template: