安装
安装
安装要求
- PHP 7.2.5 或更高
- Laravel 7.0 或更高
访问 GitHub 上的 composer.json 文件 以获取完整的扩展包要求列表。
安装扩展包
composer require livewire/livewire
引入资产
在您的模板的 head
标签中和 body
标签末尾添加以下 Blade
指令。
<html>
<head>
...
@livewireStyles
</head>
<body>
...
@livewireScripts
</body>
</html>
您也可以使用标记语法。
<livewire:styles />
...
<livewire:scripts />
就是这样!这就是您在开始使用 Livewire 前所需要做的全部内容。此页面上的其他内容全都是可选性的。
发布配置文件
Livewire 以「零配置」开箱即用为目标,然而,某些用户也需要更多的配置选项。
您可以使用以下 artisan 命令发布 Livewire 的配置文件:
php artisan livewire:publish --config
发布前端资产
如果相比于 Laravel,您更希望通过 Web 服务器提供 JavaScript 资产,请使用 livewire:publish
命令:
php artisan livewire:publish --assets
为了保持资产的最新状态并避免将来的更新出现问题,我们 强烈建议 在您的 composer.json
文件中的 post-autoload-dump
脚本里添加以下命令:
{
"scripts": {
"post-autoload-dump": [
"Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
"@php artisan package:discover --ansi",
"@php artisan vendor:publish --force --tag=livewire:assets --ansi"
]
}
}
配置静态资源的基础 URL
默认情况下,Livewire 在您的应用中通过路由 /livewire/livewire.js
提供它的 JavaScript 部分(livewire.js
)。
实际生成的脚本元素标签默认是这样的:<script src="/livewire/livewire.js"></script>"
有两种情况可以更改此默认行为:
您发布了 Livewire 资产,现在可以通过「assets」之类的子文件夹提供资产。
您的应用托管在域名的非根路径上。例如:
https://your-laravel-app.com/application
。在这种情况下,实际资产将通过/application/livewire/livewire.js
提供,但是生成的脚本元素标签将尝试从/livewire/livewire.js
获取。
要解决这两个问题,您可以在 config/livewire.php
中配置「asset_url」来自定义 src =""
属性的前缀。
例如,在发布 Livewire 的配置文件后,以下设置将解决以上两个问题:
'asset_url' => '/assets'
'asset_url' => '/application'