編輯資源 Mix
編輯資源 Mix
編譯資源 (Mix)
簡介
Laravel Mix 提供了定義 Webpack 構(gòu)建步驟的 API，用于在應(yīng)用中使用常見的 CSS 和 JavaScript 預(yù)處理器。通過鏈式調(diào)用這些簡潔方法，可以流暢地定義資源管道。例如：
如果對如何開始使用 Webpack 和資源編譯感到困惑和不知所措，那么你一定會喜歡 Laravel Mix。但是，你不一定非要使用它來開發(fā)應(yīng)用；可以使用你喜歡的任何資源管道工具，甚至干脆不用。
安裝 & 設(shè)置
安裝 Node
在觸發(fā) Mix 之前，要先確保機器上已經(jīng)安裝了 Node.js 和 NPM。
node -v npm -v
默認情況下， Laravel Homestead 包含了你需要的所有東西；不過如果你使用 Vagrant，你也能使用從 它們的下載頁面 獲取的更易用的圖形化安裝器安裝最新版本的 Node 和 NPM。
Laravel Mix
剩下的事兒就是安裝 Laravel Mix。在 Laravel 的純凈安裝版中，可以在目錄結(jié)構(gòu)的根目錄中找到 package.json 文件。默認的 package.json 文件包含了起步所需的所有東西，把它想像成 composer.json 文件，只不過它是定義 Node 的依賴項，而不是 PHP 的。通過運行如下命令來安裝它引用的依賴：
npm install
運行 Mix
Mix 是 Webpack 的頂層配置，因此運行 Mix 任務(wù)，只需要執(zhí)行一條包含在 Laravel 默認的 package.json 文件中的腳本：
// 運行 Mix 任務(wù)... npm run dev // 運行所有的 Mix 任務(wù)并最小化輸出結(jié)果... npm run production
監(jiān)聽資源變化
npm run watch 命令能夠在終端持續(xù)運行并且監(jiān)聽相關(guān)文件的變化。一旦它發(fā)現(xiàn)改變，Webpack 將自動重新編譯資源：
npm run watch
你會發(fā)現(xiàn)在特定環(huán)境下，文件發(fā)生改變并不會促使 Webpack 更新。如果系統(tǒng)中出現(xiàn)這種情況，不妨考慮使用 watch-poll 命令：
npm run watch-poll
使用樣式表
webpack.mix.js 文件所有資源編譯的切入點。把它想像為 Webpack 的輕量級配置封裝。Mix 任務(wù)可以與如何編譯資源的配置一起被鏈式調(diào)用。
Less
less 方法可用于將 Less 編譯成 CSS。下面的語句將 app.less 文件編譯為 public/css/app.css：
mix.less('resources/less/app.less', 'public/css');可以通過多次調(diào)用 less 方法完成多文件編譯：
mix.less('resources/less/app.less', 'public/css')
.less('resources/less/admin.less', 'public/css');如果希望自定義編譯后的 CSS 文件名，可以把完整的文件路徑作為傳遞給 less 方法的第二個參數(shù)：
mix.less('resources/less/app.less', 'public/stylesheets/styles.css');如果需要覆蓋 隱含的 Less 插件選項 ，可以傳遞一個對象作為 mix.less() 的第三個參數(shù)：
mix.less('resources/less/app.less', 'public/css', {
strictMath: true
});Sass
sass 方法能將 Sass 編譯成 CSS?？梢韵裣旅孢@樣使用這個方法：
mix.sass('resources/sass/app.scss', 'public/css');和 less 方法類似，可以將多個 Sass 文件編譯為各自的 CSS 文件，并為結(jié)果 CSS 自定義輸出目錄：
mix.sass('resources/sass/app.sass', 'public/css')
.sass('resources/sass/admin.sass', 'public/css/admin');額外的 Node-Sass 插件選項 可以作為第三個參數(shù)：
mix.sass('resources/sass/app.sass', 'public/css', {
precision: 5
});Stylus
與 Less 和 Sass 相似， stylus 方法將 Stylus 編譯成 CSS：
mix.stylus('resources/stylus/app.styl', 'public/css');還可以安裝額外的 Stylus 插件，比如 Rupture 。先通過 NPM （npm install rupture）安裝有插件，然后在調(diào)用 mix.stylus() 時包含它：
mix.stylus('resources/stylus/app.styl', 'public/css', {
use: [
require('rupture')()
]
});PostCSS
PostCSS 是一個轉(zhuǎn)換 CSS 的強力工具，它已經(jīng)包含在 Laravel Mix 中。默認情況下，Mix 利用流行的 Autoprefixer 插件自動附加所有必要的 CSS3 第三方前綴。不過，你可以自由添加應(yīng)用中所需的任何附加插件。首先通過 NPM 安裝所需插件，然后在 webpack.mix.js 文件引用：
mix.sass('resources/sass/app.scss', 'public/css')
.options({
postCss: [
require('postcss-css-variables')()
]
});原生 CSS
如果想要將幾個原生 CSS 樣式表合并到單個文件中，可以使用 styles 方法。
mix.styles([ 'public/css/vendor/normalize.css', 'public/css/vendor/videojs.css'], 'public/css/all.css' );
URL 處理
因為是基于 Webpack 之上構(gòu)建，了解幾個 Webpack 概念就很重要了。對于 CSS 編譯，Webpack 將重寫和優(yōu)化任何帶有樣式表的 url() 調(diào)用。雖然初聽上去好像很奇怪，但這確實是個強大的功能。 想像一下我們想要編譯包含圖片相對 URL 的 Sass：
.example {
background: url('../images/example.png');
}{note} 任何給定
url()的絕對路徑將被排除在 URL 重寫之外。例如url('/images/thing.png')或url('http://example.com/images/thing.png')將不會被修改。
默認情況下，Laravel Mix 和 Webpack 將找到 example.png, 將其復(fù)制到 public/images 文件夾，然后重寫生成的樣式表中的 url()。如此一平，編譯后的 CSS 將變成：
.example {
background: url(/images/example.png?d41d8cd98f00b204e9800998ecf8427e);
}盡管此功能可能很有用，但是已有文件夾結(jié)構(gòu)可能已經(jīng)按你的預(yù)期做了配置。這種情況下，你可以禁用 url() 重寫：
mix.sass('resources/app/app.scss', 'public/css')
.options({
processCssUrls: false
});在 webpack.mix.js 文件中加入這項配置，Mix 將不再匹配任何 url() 或者復(fù)制資源到 public 目錄。換句話說，編譯后的 CSS 看上去和你原來輸入的內(nèi)容一樣：
.example {
background: url("../images/thing.png");
}源碼映射
雖然默認情況下源碼映射被禁用，但是可以通過在 webpack.mix.js 文件中調(diào)用 mix.sourceMaps() 方法來激活。盡管會提高編譯 / 執(zhí)行的成本，卻可以在在編譯資源時為瀏覽器開發(fā)工具提供額外的調(diào)試信息。
mix.js('resources/js/app.js', 'public/js')
.sourceMaps();使用 JavaScript
Mix 提供了幾個有助于使用 JavaScript 文件的特性，比如編譯 ECMAScript 2015、模塊打包、最小化和合并原生 JavaScript 文件。更棒的是，所有這些都無需配置就可以很好地工作。
mix.js('resources/js/app.js', 'public/js');只需這一行代碼，就可以支持：
- ES2015 語法
- 模塊
- 編譯
.vue文件。 - 為生產(chǎn)環(huán)境最小化代碼。
Vendor 提取
將應(yīng)用自身的 JavaScript 和第三方庫綁定在一起有個潛在的缺點：會使長期緩存變得困難。例如，應(yīng)用代碼的單獨更新將強制瀏覽器重新下載全部第三方庫，即使第三方庫沒有發(fā)生變化。
如果你打算頻繁地更新應(yīng)用中的 JavaScript，應(yīng)該考慮將第三方庫提取到它自己的文件中。這樣一來，應(yīng)用代碼的改變將不影響 vendor.js 文件緩存。Mix 的 extract 方法為之提供了便利：
mix.js('resources/js/app.js', 'public/js')
.extract(['vue'])extract 方法接受你想要提取到 vendor.js 的全部庫或模塊的數(shù)組作為參數(shù)。使用上面例子中的代碼片段，Mix 將生成如下文件：
public/js/manifest.js: Webpack 運行時清單public/js/vendor.js: 第三方庫代碼public/js/app.js: 應(yīng)用代碼
為避免 JavaScript 錯誤，應(yīng)確保按適應(yīng)順序加載這些文件：
<script src="/js/manifest.js"></script> <script src="/js/vendor.js"></script> <script src="/js/app.js"></script>
React
Mix 能自動安裝 React 支持所需的 Babel 插件。要達成此目的，只需要用 mix.react() 替換 mix.js() ：
mix.react('resources/js/app.jsx', 'public/js');Mix 將在后臺下載并包含適用的 babel-preset-react Babel 插件。
Vanilla JS
與利用 mix.styles() 整合樣式表類似，你也可以使用 scripts() 方法整合并最小化任意數(shù)量的 JavaScript 文件：
mix.scripts([ 'public/js/admin.js', 'public/js/dashboard.js'], 'public/js/all.js' );
對于不需要使用 Webpack 編譯 JavaScript 的遺留代碼，這個選項尤其有用。
{tip}
mix.babel()是mix.scripts()的一個小變種。它的方法簽名與scripts完全相同；但整合的文件將經(jīng)由 Babel 編譯，它會將 ES2015 代碼轉(zhuǎn)換為瀏覽器能夠理解的 vanilla JavaScript。
自定義 Webpack 配置
Lavarel Mix 在后臺引用預(yù)先配置的 webpack.config.js 文件以加速啟動和運行。有時，你可能需要手動編輯這個文件。你可能有一個特殊的加載器或插件需要引用，或者可能更愿意用 Stylus 代替 Sass。這種情況下，你有兩個選擇：
合并自定義配置
Mix 提供了 webpackConfig 方法來合并任意簡短的 Webpack 配置以覆蓋已有配置。這是個非常勾人的選擇，因為它不要求你復(fù)制和維護你自己的 webpack.config.js 副本。 webpackConfig 方法接受一個對象作為作參數(shù)，它包含你想要應(yīng)用的任何 Webpack 特定配置 ，
mix.webpackConfig({
resolve: {
modules: [
path.resolve(__dirname, 'vendor/laravel/spark/resources/assets/js')
]
}
}
);自定義配置文件
如果你想完全自定義 Webpack 配置，將 node_modules/laravel-mix/setup/webpack.config.js 文件復(fù)制到項目的根目錄。然后將 package.json 文件中所有的 --config 引用都指向新復(fù)制的配置文件。如果選擇用這種方式自定義配置，Mix webpack.config.js 后續(xù)的任何更新，都必須手動合并到你的自定義配置文件中。
復(fù)制文件 & 目錄
copy 方法可以用于將文件和目錄復(fù)制到新位置。當(dāng) node_modules 目錄中特殊的資源需要重新定位到 public 文件夾時，這個方法很有用。
mix.copy('node_modules/foo/bar.css', 'public/css/bar.css');復(fù)制文件夾時， copy 方法將扁平化目錄結(jié)構(gòu)。想要保持目錄的原始結(jié)構(gòu)，需要使用 copyDirectory 方法：
mix.copyDirectory('resources/img', 'public/img');版本管理 / 緩存銷毀
許多開發(fā)者在他們編譯后的資源添加時間戳或唯一令牌作后綴，強制瀏覽器加載新的資源，以替換舊的代碼副本。Mix 可以使用 version 方法替你處理它們。.
version 方法自動在所有編譯后的文件名后追加唯一的哈希值，從而實現(xiàn)更方便的緩存銷毀：
mix.js('resources/js/app.js', 'public/js')
.version();在生成版本化文件后，你不會知道確切的文件名。因此，你需要在 views 中使用 Laravel 的全局 mix 函數(shù)載入相應(yīng)的哈希資源。 mix 函數(shù)自動判斷哈希文件的當(dāng)前文件名：
<script src="{{ mix('/js/app.js') }}"></script>通常在開發(fā)階段不需要版本化文件，你可以僅在運行 npm run production 時執(zhí)行版本化處理：
mix.js('resources/js/app.js', 'public/js');
if (mix.inProduction()) {
mix.version();
}Browsersync 重加載
BrowserSync 能夠自動監(jiān)測文件變化，并且無需手動刷新就將變化注入到瀏覽器?？梢哉{(diào)用 mix.browserSync() 方法開啟此項支持：
mix.browserSync('my-domain.test');
// 或...
// https://browsersync.io/docs/options
mix.browserSync({
proxy: 'my-domain.test'
});可以傳遞字符串（代理）或?qū)ο?Y（BrowserSync 設(shè)置）給此方法。然后使用 npm run watch 命令啟動 Webpack 的開發(fā)服務(wù)器。再編輯腳本或者 PHP 文件，就會看到瀏覽器立即刷新以響應(yīng)你的修改。
環(huán)境變量
可以通過在 .env 文件中添加 MIX_ 前綴，將環(huán)境變量注入到 Mix：
MIX_SENTRY_DSN_PUBLIC=http://example.com
一旦此變量被定義在 .env 文件中，就可以借助 process.env 對象訪問它。如果在運行 watch 任務(wù)時這個值發(fā)生改，就需要重啟任務(wù)：
process.env.MIX_SENTRY_DSN_PUBLIC
通知
如果可用，Mix 將自動為每次綁定顯示操作系統(tǒng)通知。這將為你提供編譯是否成功的實時反饋。不過，可能在某些情況下，你希望禁用通知。一個例子是在生產(chǎn)服務(wù)器上觸發(fā) Mix。通知可以借助 disableNotifications 方法來信用。
mix.disableNotifications();