You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: installation.md
+12-10
Original file line number
Diff line number
Diff line change
@@ -105,7 +105,7 @@ composer run dev
105
105
106
106
Once you have started the development server, your application will be accessible in your web browser at [http://localhost:8000](http://localhost:8000). Next, you're ready to [start taking your next steps into the Laravel ecosystem](#next-steps). Of course, you may also want to [configure a database](#databases-and-migrations).
107
107
108
-
> [!NOTE]
108
+
> [!NOTE]
109
109
> If you would like a head start when developing your Laravel application, consider using one of our [starter kits](/docs/{{version}}/starter-kits). Laravel's starter kits provide backend and frontend authentication scaffolding for your new Laravel application.
110
110
111
111
<aname="initial-configuration"></a>
@@ -122,7 +122,7 @@ Since many of Laravel's configuration option values may vary depending on whethe
122
122
123
123
Your `.env` file should not be committed to your application's source control, since each developer / server using your application could require a different environment configuration. Furthermore, this would be a security risk in the event an intruder gains access to your source control repository, since any sensitive credentials would be exposed.
124
124
125
-
> [!NOTE]
125
+
> [!NOTE]
126
126
> For more information about the `.env` file and environment based configuration, check out the full [configuration documentation](/docs/{{version}}/configuration#environment-configuration).
127
127
128
128
<aname="databases-and-migrations"></a>
@@ -149,7 +149,7 @@ If you choose to use a database other than SQLite, you will need to create the d
149
149
php artisan migrate
150
150
```
151
151
152
-
> [!NOTE]
152
+
> [!NOTE]
153
153
> If you are developing on macOS or Windows and need to install MySQL, PostgreSQL, or Redis locally, consider using [Herd Pro](https://herd.laravel.com/#plans).
154
154
155
155
<aname="directory-configuration"></a>
@@ -164,7 +164,7 @@ Laravel should always be served out of the root of the "web directory" configure
164
164
165
165
Once you install Herd, you're ready to start developing with Laravel. Herd includes command line tools for `php`, `composer`, `laravel`, `expose`, `node`, `npm`, and `nvm`.
166
166
167
-
> [!NOTE]
167
+
> [!NOTE]
168
168
> [Herd Pro](https://herd.laravel.com/#plans) augments Herd with additional powerful features, such as the ability to create and manage local MySQL, Postgres, and Redis databases, as well as local mail viewing and log monitoring.
169
169
170
170
<aname="herd-on-macos"></a>
@@ -216,7 +216,7 @@ Docker is a tool for running applications and services in small, light-weight "c
216
216
217
217
Laravel Sail is a light-weight command-line interface for interacting with Laravel's default Docker configuration. Sail provides a great starting point for building a Laravel application using PHP, MySQL, and Redis without requiring prior Docker experience.
218
218
219
-
> [!NOTE]
219
+
> [!NOTE]
220
220
> Already a Docker expert? Don't worry! Everything about Sail can be customized using the `docker-compose.yml` file included with Laravel.
221
221
222
222
<aname="sail-on-macos"></a>
@@ -248,15 +248,15 @@ Once the application's Docker containers have started, you should run your appli
248
248
249
249
Finally, you can access the application in your web browser at: http://localhost.
250
250
251
-
> [!NOTE]
251
+
> [!NOTE]
252
252
> To continue learning more about Laravel Sail, review its [complete documentation](/docs/{{version}}/sail).
253
253
254
254
<aname="sail-on-windows"></a>
255
255
### Sail on Windows
256
256
257
257
Before we create a new Laravel application on your Windows machine, make sure to install [Docker Desktop](https://www.docker.com/products/docker-desktop). Next, you should ensure that Windows Subsystem for Linux 2 (WSL2) is installed and enabled. WSL allows you to run Linux binary executables natively on Windows 10. Information on how to install and enable WSL2 can be found within Microsoft's [developer environment documentation](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
258
258
259
-
> [!NOTE]
259
+
> [!NOTE]
260
260
> After installing and enabling WSL2, you should ensure that Docker Desktop is [configured to use the WSL2 backend](https://docs.docker.com/docker-for-windows/wsl/).
261
261
262
262
Next, you are ready to create your first Laravel application. Launch [Windows Terminal](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701?rtc=1&activetab=pivot:overviewtab) and begin a new terminal session for your WSL2 Linux operating system. Next, you can use a simple terminal command to create a new Laravel application. For example, to create a new Laravel application in a directory named "example-app", you may run the following command in your terminal:
@@ -285,7 +285,7 @@ Once the application's Docker containers have started, you should run your appli
285
285
286
286
Finally, you can access the application in your web browser at: http://localhost.
287
287
288
-
> [!NOTE]
288
+
> [!NOTE]
289
289
> To continue learning more about Laravel Sail, review its [complete documentation](/docs/{{version}}/sail).
290
290
291
291
#### Developing Within WSL2
@@ -331,7 +331,7 @@ Once the application's Docker containers have started, you should run your appli
331
331
332
332
Finally, you can access the application in your web browser at: http://localhost.
333
333
334
-
> [!NOTE]
334
+
> [!NOTE]
335
335
> To continue learning more about Laravel Sail, review its [complete documentation](/docs/{{version}}/sail).
336
336
337
337
<aname="choosing-your-sail-services"></a>
@@ -358,6 +358,8 @@ You are free to use any code editor you wish when developing Laravel application
358
358
359
359
In addition, the community maintained [Laravel Idea](https://laravel-idea.com/) PhpStorm plugin offers a variety of helpful IDE augmentations, including code generation, Eloquent syntax completion, validation rule completion, and more.
360
360
361
+
If you develop in [Visual Studio Code (VS Code)](https://code.visualstudio.com), the official [Laravel VS Code Extension](https://marketplace.visualstudio.com/items?itemName=laravel.vscode-laravel) is now available. This extension brings Laravel-specific tools directly into your VS Code environment, enhancing productivity.
362
+
361
363
<aname="next-steps"></a>
362
364
## Next Steps
363
365
@@ -385,7 +387,7 @@ If this is how you plan to use Laravel, you may want to check out our documentat
385
387
386
388
If you are using Laravel as a full stack framework, we also strongly encourage you to learn how to compile your application's CSS and JavaScript using [Vite](/docs/{{version}}/vite).
387
389
388
-
> [!NOTE]
390
+
> [!NOTE]
389
391
> If you want to get a head start building your application, check out one of our official [application starter kits](/docs/{{version}}/starter-kits).
0 commit comments