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: mail.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -379,7 +379,7 @@ public function content(): Content
379
379
}
380
380
```
381
381
382
-
> [!NOTE]
382
+
> [!NOTE]
383
383
> You may wish to create a `resources/views/emails` directory to house all of your email templates; however, you are free to place them wherever you wish within your `resources/views` directory.
384
384
385
385
<aname="plain-text-emails"></a>
@@ -637,7 +637,7 @@ Embedding inline images into your emails is typically cumbersome; however, Larav
637
637
</body>
638
638
```
639
639
640
-
> [!WARNING]
640
+
> [!WARNING]
641
641
> The `$message` variable is not available in plain-text message templates since plain-text messages do not utilize inline attachments.
642
642
643
643
<aname="embedding-raw-data-attachments"></a>
@@ -851,7 +851,7 @@ Thanks,<br>
851
851
</x-mail::message>
852
852
```
853
853
854
-
> [!NOTE]
854
+
> [!NOTE]
855
855
> Do not use excess indentation when writing Markdown emails. Per Markdown standards, Markdown parsers will render indented content as code blocks.
856
856
857
857
<aname="button-component"></a>
@@ -1073,7 +1073,7 @@ class OrderShipped extends Mailable implements ShouldQueue
1073
1073
}
1074
1074
```
1075
1075
1076
-
> [!NOTE]
1076
+
> [!NOTE]
1077
1077
> To learn more about working around these issues, please review the documentation regarding [queued jobs and database transactions](/docs/{{version}}/queues#jobs-and-database-transactions).
Copy file name to clipboardExpand all lines: middleware.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -60,7 +60,7 @@ As you can see, if the given `token` does not match our secret token, the middle
60
60
61
61
It's best to envision middleware as a series of "layers" HTTP requests must pass through before they hit your application. Each layer can examine the request and even reject it entirely.
62
62
63
-
> [!NOTE]
63
+
> [!NOTE]
64
64
> All middleware are resolved via the [service container](/docs/{{version}}/container), so you may type-hint any dependencies you need within a middleware's constructor.
65
65
66
66
<aname="middleware-and-responses"></a>
@@ -325,7 +325,7 @@ If you would like to manually manage all of the middleware within Laravel's defa
325
325
})
326
326
```
327
327
328
-
> [!NOTE]
328
+
> [!NOTE]
329
329
> By default, the `web` and `api` middleware groups are automatically applied to your application's corresponding `routes/web.php` and `routes/api.php` files by the `bootstrap/app.php` file.
Copy file name to clipboardExpand all lines: migrations.md
+8-8
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ Laravel will use the name of the migration to attempt to guess the name of the t
44
44
45
45
If you would like to specify a custom path for the generated migration, you may use the `--path` option when executing the `make:migration` command. The given path should be relative to your application's base path.
46
46
47
-
> [!NOTE]
47
+
> [!NOTE]
48
48
> Migration stubs may be customized using [stub publishing](/docs/{{version}}/artisan#stub-customization).
You should commit your database schema file to source control so that other new developers on your team may quickly create your application's initial database structure.
72
72
73
-
> [!WARNING]
73
+
> [!WARNING]
74
74
> Migration squashing is only available for the MariaDB, MySQL, PostgreSQL, and SQLite databases and utilizes the database's command-line client.
75
75
76
76
<aname="migration-structure"></a>
@@ -165,7 +165,7 @@ When the `isolated` option is provided, Laravel will acquire an atomic lock usin
165
165
php artisan migrate --isolated
166
166
```
167
167
168
-
> [!WARNING]
168
+
> [!WARNING]
169
169
> To utilize this feature, your application must be using the `memcached`, `redis`, `dynamodb`, `database`, `file`, or `array` cache driver as your application's default cache driver. In addition, all servers must be communicating with the same central cache server.
@@ -245,7 +245,7 @@ By default, the `migrate:fresh` command only drops tables from the default datab
245
245
php artisan migrate:fresh --database=admin
246
246
```
247
247
248
-
> [!WARNING]
248
+
> [!WARNING]
249
249
> The `migrate:fresh` command will drop all database tables regardless of their prefix. This command should be used with caution when developing on a database that is shared with other applications.
250
250
251
251
<aname="tables"></a>
@@ -722,7 +722,7 @@ The `geography` method creates a `GEOGRAPHY` equivalent column with the given sp
> Support for spatial types depends on your database driver. Please refer to your database's documentation. If your application is utilizing a PostgreSQL database, you must install the [PostGIS](https://postgis.net) extension before the `geography` method may be used.
727
727
728
728
<aname="column-method-geometry"></a>
@@ -734,7 +734,7 @@ The `geometry` method creates a `GEOMETRY` equivalent column with the given spat
> Support for spatial types depends on your database driver. Please refer to your database's documentation. If your application is utilizing a PostgreSQL database, you must install the [PostGIS](https://postgis.net) extension before the `geometry` method may be used.
739
739
740
740
<aname="column-method-id"></a>
@@ -1229,7 +1229,7 @@ return new class extends Migration
1229
1229
};
1230
1230
```
1231
1231
1232
-
> [!WARNING]
1232
+
> [!WARNING]
1233
1233
> Support for default expressions depends on your database driver, database version, and the field type. Please refer to your database's documentation.
> SQLite disables foreign key constraints by default. When using SQLite, make sure to [enable foreign key support](/docs/{{version}}/database#configuration) in your database configuration before attempting to create them in your migrations.
If you've ever been confused and overwhelmed about getting started with webpack and asset compilation, you will love Laravel Mix. However, you are not required to use it while developing your application; you are free to use any asset pipeline tool you wish, or even none at all.
18
18
19
-
> [!NOTE]
19
+
> [!NOTE]
20
20
> Vite has replaced Laravel Mix in new Laravel installations. For Mix documentation, please visit the [official Laravel Mix](https://laravel-mix.com/) website. If you would like to switch to Vite, please see our [Vite migration guide](https://github.com/laravel/vite-plugin/blob/main/UPGRADE.md#migrating-from-laravel-mix-to-vite).
Copy file name to clipboardExpand all lines: mocking.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -154,7 +154,7 @@ class UserControllerTest extends TestCase
154
154
}
155
155
```
156
156
157
-
> [!WARNING]
157
+
> [!WARNING]
158
158
> You should not mock the `Request` facade. Instead, pass the input you desire into the [HTTP testing methods](/docs/{{version}}/http-tests) such as `get` and `post` when running your test. Likewise, instead of mocking the `Config` facade, call the `Config::set` method in your tests.
Copy file name to clipboardExpand all lines: mongodb.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -66,7 +66,7 @@ Finally, use Composer to install the Laravel MongoDB package:
66
66
composer require mongodb/laravel-mongodb
67
67
```
68
68
69
-
> [!NOTE]
69
+
> [!NOTE]
70
70
> This installation of the package will fail if the `mongodb` PHP extension is not installed. The PHP configuration can differ between the CLI and the web server, so ensure the extension is enabled in both configurations.
@@ -204,7 +204,7 @@ Using Laravel Octane with Open Swoole grants the same functionality provided by
204
204
<a name="swoole-via-laravel-sail"></a>
205
205
#### Swoole via Laravel Sail
206
206
207
-
> [!WARNING]
207
+
> [!WARNING]
208
208
> Before serving an Octane application via Sail, ensure you have the latest version of Laravel Sail and execute `./vendor/bin/sail build --no-cache` within your application's root directory.
209
209
210
210
Alternatively, you may develop your Swoole based Octane application using [Laravel Sail](/docs/{{version}}/sail), the official Docker based development environment for Laravel. Laravel Sail includes the Swoole extension by default. However, you will still need to adjust the `docker-compose.yml` file used by Sail.
@@ -261,7 +261,7 @@ By default, applications running via Octane generate links prefixed with `http:/
261
261
<a name="serving-your-application-via-nginx"></a>
262
262
### Serving Your Application via Nginx
263
263
264
-
> [!NOTE]
264
+
> [!NOTE]
265
265
> If you aren't quite ready to manage your own server configuration or aren't comfortable configuring all of the various services needed to run a robust Laravel Octane application, check out [Laravel Cloud](https://cloud.laravel.com), which offers fully-managed Laravel Octane support.
266
266
267
267
In production environments, you should serve your Octane application behind a traditional web server such as Nginx or Apache. Doing so will allow the web server to serve your static assets such as images and stylesheets, as well as manage your SSL certificate termination.
The global `request` helper will always return the request the application is currently handling and is therefore safe to use within your application.
484
484
485
-
> [!WARNING]
485
+
> [!WARNING]
486
486
> It is acceptable to type-hint the `Illuminate\Http\Request` instance on your controller methods and route closures.
487
487
488
488
<a name="configuration-repository-injection"></a>
@@ -553,7 +553,7 @@ While building your application, you should take special care to avoid creating
553
553
<a name="concurrent-tasks"></a>
554
554
## Concurrent Tasks
555
555
556
-
> [!WARNING]
556
+
> [!WARNING]
557
557
> This feature requires [Swoole](#swoole).
558
558
559
559
When using Swoole, you may execute operations concurrently via light-weight background tasks. You may accomplish this using Octane's `concurrently` method. You may combine this method with PHP array destructuring to retrieve the results of each operation:
@@ -580,7 +580,7 @@ When invoking the `concurrently` method, you should not provide more than 1024 t
580
580
<a name="ticks-and-intervals"></a>
581
581
## Ticks and Intervals
582
582
583
-
> [!WARNING]
583
+
> [!WARNING]
584
584
> This feature requires [Swoole](#swoole).
585
585
586
586
When using Swoole, you may register "tick" operations that will be executed every specified number of seconds. You may register "tick" callbacks via the `tick` method. The first argument provided to the `tick` method should be a string that represents the name of the ticker. The second argument should be a callable that will be invoked at the specified interval.
When using Swoole, you may leverage the Octane cache driver, which provides read and write speeds of up to 2 million operations per second. Therefore, this cache driver is an excellent choice for applications that need extreme read / write speeds from their caching layer.
@@ -614,7 +614,7 @@ This cache driver is powered by [Swoole tables](https://www.swoole.co.uk/docs/mo
> The maximum number of entries allowed in the Octane cache may be defined in your application's `octane` configuration file.
619
619
620
620
<a name="cache-intervals"></a>
@@ -633,7 +633,7 @@ Cache::store('octane')->interval('random', function () {
633
633
<a name="tables"></a>
634
634
## Tables
635
635
636
-
> [!WARNING]
636
+
> [!WARNING]
637
637
> This feature requires [Swoole](#swoole).
638
638
639
639
When using Swoole, you may define and interact with your own arbitrary [Swoole tables](https://www.swoole.co.uk/docs/modules/swoole-table). Swoole tables provide extreme performance throughput and the data in these tables can be accessed by all workers on the server. However, the data within them will be lost when the server is restarted.
Copy file name to clipboardExpand all lines: packages.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -111,7 +111,7 @@ Now, when users of your package execute Laravel's `vendor:publish` command, your
111
111
$value = config('courier.option');
112
112
```
113
113
114
-
> [!WARNING]
114
+
> [!WARNING]
115
115
> You should not define closures in your configuration files. They cannot be serialized correctly when users execute the `config:cache` Artisan command.
116
116
117
117
<aname="default-package-configuration"></a>
@@ -133,7 +133,7 @@ public function register(): void
133
133
}
134
134
```
135
135
136
-
> [!WARNING]
136
+
> [!WARNING]
137
137
> This method only merges the first level of the configuration array. If your users partially define a multi-dimensional configuration array, the missing options will not be merged.
Once you have retrieved a cursor paginator instance, you may [display the pagination results](#displaying-pagination-results) as you typically would when using the `paginate` and `simplePaginate` methods. For more information on the instance methods offered by the cursor paginator, please consult the [cursor paginator instance method documentation](#cursor-paginator-instance-methods).
139
139
140
-
> [!WARNING]
140
+
> [!WARNING]
141
141
> Your query must contain an "order by" clause in order to take advantage of cursor pagination. In addition, the columns that the query are ordered by must belong to the table you are paginating.
142
142
143
143
<aname="cursor-vs-offset-pagination"></a>
@@ -174,7 +174,7 @@ The `Paginator` and `CursorPaginator` classes do not need to know the total numb
174
174
175
175
In other words, the `Paginator` corresponds to the `simplePaginate` method on the query builder, the `CursorPaginator` corresponds to the `cursorPaginate` method, and the `LengthAwarePaginator` corresponds to the `paginate` method.
176
176
177
-
> [!WARNING]
177
+
> [!WARNING]
178
178
> When manually creating a paginator instance, you should manually "slice" the array of results you pass to the paginator. If you're unsure how to do this, check out the [array_slice](https://secure.php.net/manual/en/function.array-slice.php) PHP function.
0 commit comments