space lists

This commit is contained in:
Taylor Otwell 2022-02-06 16:41:13 -06:00
parent 6f7acb4c32
commit 8c4b6af2e0
13 changed files with 50 additions and 0 deletions

View File

@ -23,6 +23,7 @@ Remember, bug reports are created in the hope that others with the same problem
The Laravel source code is managed on GitHub, and there are repositories for each of the Laravel projects:
<div class="content-list" markdown="1">
- [Laravel Application](https://github.com/laravel/laravel)
- [Laravel Art](https://github.com/laravel/art)
- [Laravel Documentation](https://github.com/laravel/docs)
@ -37,6 +38,7 @@ The Laravel source code is managed on GitHub, and there are repositories for eac
- [Laravel Socialite](https://github.com/laravel/socialite)
- [Laravel Telescope](https://github.com/laravel/telescope)
- [Laravel Website](https://github.com/laravel/laravel.com-next)
</div>
<a name="support-questions"></a>
@ -45,12 +47,14 @@ The Laravel source code is managed on GitHub, and there are repositories for eac
Laravel's GitHub issue trackers are not intended to provide Laravel help or support. Instead, use one of the following channels:
<div class="content-list" markdown="1">
- [Laracasts Forums](https://laracasts.com/discuss)
- [Laravel.io Forums](https://laravel.io/forum)
- [StackOverflow](https://stackoverflow.com/questions/tagged/laravel)
- [Discord](https://discordapp.com/invite/KxwQuKb)
- [Larachat](https://larachat.co)
- [IRC](https://webchat.freenode.net/?nick=artisan&channels=%23laravel&prompt=1)
</div>
<a name="core-development-discussion"></a>
@ -117,8 +121,10 @@ Don't worry if your code styling isn't perfect! [StyleCI](https://styleci.io/) w
The Laravel code of conduct is derived from the Ruby code of conduct. Any violations of the code of conduct may be reported to Taylor Otwell (taylor@laravel.com):
<div class="content-list" markdown="1">
- Participants will be tolerant of opposing views.
- Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
- When interpreting the words and actions of others, participants should always assume good intentions.
- Behavior which can be reasonably considered harassment will not be tolerated.
</div>

View File

@ -14,10 +14,12 @@
Laravel makes interacting with databases extremely simple across a variety of database backends using either raw SQL, the [fluent query builder](/docs/{{version}}/queries), and the [Eloquent ORM](/docs/{{version}}/eloquent). Currently, Laravel supports four databases:
<div class="content-list" markdown="1">
- MySQL 5.6+ ([Version Policy](https://en.wikipedia.org/wiki/MySQL#Release_history))
- PostgreSQL 9.4+ ([Version Policy](https://www.postgresql.org/support/versioning/))
- SQLite 3.8.8+
- SQL Server 2017+ ([Version Policy](https://support.microsoft.com/en-us/lifecycle/search))
</div>
<a name="configuration"></a>

View File

@ -677,6 +677,7 @@ Dusk provides a variety of assertions that you may make against your application
</style>
<div class="collection-method-list" markdown="1">
[assertTitle](#assert-title)
[assertTitleContains](#assert-title-contains)
[assertUrlIs](#assert-url-is)
@ -733,6 +734,7 @@ Dusk provides a variety of assertions that you may make against your application
[assertVueIsNot](#assert-vue-is-not)
[assertVueContains](#assert-vue-contains)
[assertVueDoesNotContain](#assert-vue-does-not-contain)
</div>
<a name="assert-title"></a>

View File

@ -36,6 +36,7 @@
Database tables are often related to one another. For example, a blog post may have many comments, or an order could be related to the user who placed it. Eloquent makes managing and working with these relationships easy, and supports several different types of relationships:
<div class="content-list" markdown="1">
- [One To One](#one-to-one)
- [One To Many](#one-to-many)
- [Many To Many](#many-to-many)
@ -44,6 +45,7 @@ Database tables are often related to one another. For example, a blog post may h
- [One To One (Polymorphic)](#one-to-one-polymorphic-relations)
- [One To Many (Polymorphic)](#one-to-many-polymorphic-relations)
- [Many To Many (Polymorphic)](#many-to-many-polymorphic-relations)
</div>
<a name="defining-relationships"></a>

View File

@ -178,8 +178,10 @@ Envoy also supports sending notifications to [Slack](https://slack.com) after ea
You may provide one of the following as the channel argument:
<div class="content-list" markdown="1">
- To send the notification to a channel: `#channel`
- To send the notification to a user: `@user`
</div>
<a name="discord"></a>

View File

@ -57,6 +57,7 @@ Homestead runs on any Windows, Mac, or Linux system, and includes Nginx, PHP, My
</style>
<div id="software-list" markdown="1">
- Ubuntu 18.04
- Git
- PHP 7.4
@ -81,6 +82,7 @@ Homestead runs on any Windows, Mac, or Linux system, and includes Nginx, PHP, My
- Xdebug
- XHProf / Tideways / XHGui
- wp-cli
</div>
<a name="optional-software"></a>
@ -95,6 +97,7 @@ Homestead runs on any Windows, Mac, or Linux system, and includes Nginx, PHP, My
</style>
<div id="software-list" markdown="1">
- Apache
- Blackfire
- Cassandra
@ -119,6 +122,7 @@ Homestead runs on any Windows, Mac, or Linux system, and includes Nginx, PHP, My
- RabbitMQ
- Solr
- Webdriver & Laravel Dusk Utilities
</div>
<a name="installation-and-setup"></a>
@ -528,6 +532,7 @@ Supported `policy` values include: `none`, `download`, `upload`, and `public`.
By default, the following ports are forwarded to your Homestead environment:
<div class="content-list" markdown="1">
- **SSH:** 2222 &rarr; Forwards To 22
- **ngrok UI:** 4040 &rarr; Forwards To 4040
- **HTTP:** 8000 &rarr; Forwards To 80
@ -537,6 +542,7 @@ By default, the following ports are forwarded to your Homestead environment:
- **MongoDB:** 27017 &rarr; Forwards To 27017
- **Mailhog:** 8025 &rarr; Forwards To 8025
- **Minio:** 9600 &rarr; Forwards To 9600
</div>
#### Forwarding Additional Ports

View File

@ -19,6 +19,7 @@ The Laravel framework has a few system requirements. All of these requirements a
However, if you are not using Homestead, you will need to make sure your server meets the following requirements:
<div class="content-list" markdown="1">
- PHP >= 7.2.5
- BCMath PHP Extension
- Ctype PHP Extension
@ -29,6 +30,7 @@ However, if you are not using Homestead, you will need to make sure your server
- PDO PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension
</div>
<a name="installing-laravel"></a>
@ -45,9 +47,11 @@ First, download the Laravel installer using Composer:
Make sure to place Composer's system-wide vendor bin directory in your `$PATH` so the laravel executable can be located by your system. This directory exists in different locations based on your operating system; however, some common locations include:
<div class="content-list" markdown="1">
- macOS: `$HOME/.composer/vendor/bin`
- Windows: `%USERPROFILE%\AppData\Roaming\Composer\vendor\bin`
- GNU / Linux Distributions: `$HOME/.config/composer/vendor/bin` or `$HOME/.composer/vendor/bin`
</div>
You could also find Composer's global installation path by running `composer global about` and looking up from the first line.
@ -98,9 +102,11 @@ Laravel needs almost no other configuration out of the box. You are free to get
You may also want to configure a few additional components of Laravel, such as:
<div class="content-list" markdown="1">
- [Cache](/docs/{{version}}/cache#configuration)
- [Database](/docs/{{version}}/database#configuration)
- [Session](/docs/{{version}}/session#configuration)
</div>
<a name="web-server-configuration"></a>

4
mix.md
View File

@ -210,10 +210,12 @@ Mix provides several features to help you work with your JavaScript files, such
With this single line of code, you may now take advantage of:
<div class="content-list" markdown="1">
- ES2015 syntax.
- Modules
- Compilation of `.vue` files.
- Minification for production environments.
</div>
<a name="vendor-extraction"></a>
@ -229,9 +231,11 @@ If you intend to make frequent updates to your application's JavaScript, you sho
The `extract` method accepts an array of all libraries or modules that you wish to extract into a `vendor.js` file. Using the above snippet as an example, Mix will generate the following files:
<div class="content-list" markdown="1">
- `public/js/manifest.js`: *The Webpack manifest runtime*
- `public/js/vendor.js`: *Your vendor libraries*
- `public/js/app.js`: *Your application code*
</div>
To avoid JavaScript errors, be sure to load these files in the proper order:

View File

@ -101,9 +101,11 @@ Adjusting this value based on your queue load can be more efficient than continu
The following dependencies are needed for the listed queue drivers:
<div class="content-list" markdown="1">
- Amazon SQS: `aws/aws-sdk-php ~3.0`
- Beanstalkd: `pda/pheanstalk ~4.0`
- Redis: `predis/predis ~1.0` or phpredis PHP extension
</div>
<a name="creating-jobs"></a>

View File

@ -26,11 +26,13 @@ The session configuration file is stored at `config/session.php`. Be sure to rev
The session `driver` configuration option defines where session data will be stored for each request. Laravel ships with several great drivers out of the box:
<div class="content-list" markdown="1">
- `file` - sessions are stored in `storage/framework/sessions`.
- `cookie` - sessions are stored in secure, encrypted cookies.
- `database` - sessions are stored in a relational database.
- `memcached` / `redis` - sessions are stored in one of these fast, cache based stores.
- `array` - sessions are stored in a PHP array and will not be persisted.
</div>
> {tip} The array driver is used during [testing](/docs/{{version}}/testing) and prevents the data stored in the session from being persisted.
@ -225,12 +227,14 @@ Your custom session driver should implement the `SessionHandlerInterface`. This
Since the purpose of these methods is not readily understandable, let's quickly cover what each of the methods do:
<div class="content-list" markdown="1">
- The `open` method would typically be used in file based session store systems. Since Laravel ships with a `file` session driver, you will almost never need to put anything in this method. You can leave it as an empty stub. It is a fact of poor interface design (which we'll discuss later) that PHP requires us to implement this method.
- The `close` method, like the `open` method, can also usually be disregarded. For most drivers, it is not needed.
- The `read` method should return the string version of the session data associated with the given `$sessionId`. There is no need to do any serialization or other encoding when retrieving or storing session data in your driver, as Laravel will perform the serialization for you.
- The `write` method should write the given `$data` string associated with the `$sessionId` to some persistent storage system, such as MongoDB, Dynamo, etc. Again, you should not perform any serialization - Laravel will have already handled that for you.
- The `destroy` method should remove the data associated with the `$sessionId` from persistent storage.
- The `gc` method should destroy all session data that is older than the given `$lifetime`, which is a UNIX timestamp. For self-expiring systems like Memcached and Redis, this method may be left empty.
</div>
<a name="registering-the-driver"></a>

View File

@ -6,14 +6,17 @@
## High Impact Changes
<div class="content-list" markdown="1">
- [Authorized Resources & `viewAny`](#authorized-resources)
- [String & Array Helpers](#helpers)
</div>
<a name="medium-impact-changes"></a>
## Medium Impact Changes
<div class="content-list" markdown="1">
- [Carbon 1.x No Longer Supported](#carbon-support)
- [Redis Default Client](#redis-default-client)
- [Database `Capsule::table` Method](#capsule-table)
@ -26,6 +29,7 @@
- [Resend Email Verification Route](#email-verification-route)
- [Email Verification Route Change](#email-verification-route-change)
- [The `Input` Facade](#the-input-facade)
</div>
<a name="upgrade-6.0"></a>

View File

@ -36,6 +36,7 @@ Out of the box, Valet support includes, but is not limited to:
</style>
<div id="valet-support" markdown="1">
- [Laravel](https://laravel.com)
- [Lumen](https://lumen.laravel.com)
- [Bedrock](https://roots.io/bedrock/)
@ -57,6 +58,7 @@ Out of the box, Valet support includes, but is not limited to:
- [Symfony](https://symfony.com)
- [WordPress](https://wordpress.org)
- [Zend](https://framework.zend.com)
</div>
However, you may extend Valet with your own [custom drivers](#custom-valet-drivers).
@ -76,11 +78,13 @@ Both Valet and Homestead are great choices for configuring your Laravel developm
**Valet requires macOS and [Homebrew](https://brew.sh/). Before installation, you should make sure that no other programs such as Apache or Nginx are binding to your local machine's port 80.**
<div class="content-list" markdown="1">
- Install or update [Homebrew](https://brew.sh/) to the latest version using `brew update`.
- Install PHP 7.4 using Homebrew via `brew install php`.
- Install [Composer](https://getcomposer.org).
- Install Valet with Composer via `composer global require laravel/valet`. Make sure the `~/.composer/vendor/bin` directory is in your system's "PATH".
- Run the `valet install` command. This will configure and install Valet and DnsMasq, and register Valet's daemon to launch when your system starts.
</div>
Once Valet is installed, try pinging any `*.test` domain on your terminal using a command such as `ping foobar.test`. If Valet is installed correctly you should see this domain responding on `127.0.0.1`.
@ -125,9 +129,11 @@ Once Valet is installed, you're ready to start serving sites. Valet provides two
#### The `park` Command
<div class="content-list" markdown="1">
- Create a new directory on your Mac by running something like `mkdir ~/Sites`. Next, `cd ~/Sites` and run `valet park`. This command will register your current working directory as a path that Valet should search for sites.
- Next, create a new Laravel site within this directory: `laravel new blog`.
- Open `http://blog.test` in your browser.
</div>
**That's all there is to it.** Now, any Laravel project you create within your "parked" directory will automatically be served using the `http://folder-name.test` convention.
@ -138,8 +144,10 @@ Once Valet is installed, you're ready to start serving sites. Valet provides two
The `link` command may also be used to serve your Laravel sites. This command is useful if you want to serve a single site in a directory and not the entire directory.
<div class="content-list" markdown="1">
- To use the command, navigate to one of your projects and run `valet link app-name` in your terminal. Valet will create a symbolic link in `~/.config/valet/Sites` which points to your current working directory.
- After running the `link` command, you can access the site in your browser at `http://app-name.test`.
</div>
To see a listing of all of your linked directories, run the `valet links` command. You may use `valet unlink app-name` to destroy the symbolic link.

View File

@ -788,11 +788,13 @@ The field under validation must be formatted as an e-mail address. Under the hoo
The example above will apply the `RFCValidation` and `DNSCheckValidation` validations. Here's a full list of validation styles you can apply:
<div class="content-list" markdown="1">
- `rfc`: `RFCValidation`
- `strict`: `NoRFCWarningsValidation`
- `dns`: `DNSCheckValidation`
- `spoof`: `SpoofCheckValidation`
- `filter`: `FilterEmailValidation`
</div>
The `filter` validator, which uses PHP's `filter_var` function under the hood, ships with Laravel and is Laravel's pre-5.8 behavior. The `dns` and `spoof` validators require the PHP `intl` extension.