passchn / silverstripe-vite
v0.2.5
2022-11-08 22:07 UTC
Requires
- php: ^7.4 || ^8.0
- silverstripe/cms: ^4
- silverstripe/framework: ^4
README
Silverstripe 版本支持
^0.x
支持 Silverstripe 4.xdev-master
支持 Silverstripe 5.x. 注意:尚未提供稳定版本,请参阅 #3
安装
composer require passchn/silverstripe-vite
在您的 mysite.yml
Page:
extensions:
- ViteHelper\Vite\ViteDataExtension
配置
您可以在 mysite.yml
中覆盖默认配置
ViteHelper\Vite\ViteHelper:
forceProductionMode: false
devHostNeedle: '.test'
devPort: 3000
jsSrcDirectory: 'public_src/'
mainJS: 'main.js'
manifestDir: '/public/manifest.json'
ViteHelper 配置设置选项
- 如果您将
forceProductionMode
设置为 true,则将在运行vite build
后提供构建文件。 - 将
devHostNeedle
设置为区分您的实时网站和本地环境,例如localhost:8080
,mysite.test
或127.0.0.1
。- 注意: Vite 开发服务器也必须正在运行。
- 将
devPort
设置为 Vite 开发服务器的端口号,例如3000
– 在运行开发服务器时,Vite 端口将在终端中显示。为了设置固定端口号(推荐),请记住在 vite config 下的server
中设置它。两个配置中的端口号必须始终匹配。 - 定义
mainJS
入口点,即您的应用程序脚本文件所在位置。- 例如,如果您使用 TypeScript,请将
mainJs
属性更改为"main.ts"
。
- 例如,如果您使用 TypeScript,请将
- 定义
manifestDir
以确定清单文件的位置。
用法
在您的主模板中插入 JS / CSS 标签,例如,Page.ss
<head>
...
$Vite.HeaderTags.RAW
</head>
<body>
...
$Vite.BodyTags.RAW
</body>
Vite 配置
配置必须与 vite.config.js
匹配。您需要在修改 yml 配置后执行 ?flush。
有关更多信息,请参阅 ViteHelper.php。
您的 vite.config.js 或 vite.config.ts 中的配置必须与此插件的 ViteHelper 配置匹配。
请参阅此 example vite.config.ts 以获取默认配置。
注意:当使用 Vite 版本低于 2.9.0
时,服务器配置将不同。请参阅此配置。