Envoy(使節)はリモートサーバ間で共通のタスクを実行するために、美しく最小限の記法を提供します。デプロイやArtisanコマンドなどのタスクをBlade記法により簡単に準備できます。EnvoyはMacとLinuxのオペレーションシステムのみサポートしています。requireコマンドでインストールします。requireコマンドの代替として、cgrの使用を考慮してください。cgrライブラリのインストール方法は、GitHubで見つけられます。envoyコマンドを端末で実行するときにenvoyの実行ファイルが見つかるように、~/.composer/vendor/binディレクトリに実行パスを通しておくのを忘れないでください。EnvoyインストールしたEnvoyをアップデートするためにも、Composerを使用します。updateコマンドの実行により、インストール済みのグローバルComposerパッケージがすべてアップデートされます。TasksEnvoyの全タスクはプロジェクトルートのEnvoy.blade.phpファイルの中で定義します。最初に例を見てください。-la@endtask見ての通り、@serversの配列をファイルの最初で定義し、タスク定義のonオプションでそれらのサーバを参照できるようにしています。@task定義の中には、タスクが実行されるときにサーバで実行するBASHコードを記述します。executed.サーバのIPアドレスを127.0.0.1にすることで、強制的にスクリプトをローカルで実行できます。'127.0.0.1'])準備Setupタスクを実行する前に、PHPコードを評価する必要がある場合もあります。変数を宣言するために@setupディレクティブを使用し、他のタスクが実行される前に通常のPHPを動作させます。"testing";@endsetupタスク実行前に他のPHPライブラリを読み込む必要がある場合は、Envoy.blade.phpファイルの先頭で、@includeディレティブを使用してください。...@endtask変数Variables必要であれば、コマンドラインを使い、Envoyタスクへオプション値を渡すことができます。--branch=masterオプションへはBladeの"echo"記法により、タスク中からアクセスできます。if文も使用できますし、タスク内で繰り返しも可能です。pullコマンドを実行する前に、$branchの存在を確認してみましょう。migrate@endtaskストーリーStoriesストーリーにより、選択した小さなタスクを大きなタスクにまとめることができます。名前を付け、一連のタスクを一つにまとめます。一例としてタスク名をリストすることにより、deployストーリーを定義し、gitとcomposerタスクを実行してみます。install@endtaskストーリーを書き上げたら、通常のタスクと同じように実行します。ServersEnvoyでは、複数のサーバに渡りタスクを実行するのも簡単です。最初に追加のサーバを@serversディレクティブで指定してください。各サーバには一意な名前を割り当ててください。追加サーバを定義したら、タスクのon配列にサーバをリストするだけです。Executionデフォルトでタスクは各サーバで順番に実行されます。最初のサーバで実行を終えたら、次のサーバで実行されます。タスクを複数サーバで並列実行したい場合は、タスク宣言にparallelオプションを追加してください。TasksEnvoy.blade.phpファイルのタスクやストーリーを実行するには、実行したいタスクかストーリーの名前を指定し、Envoyのrunコマンドを実行します。Envoyはタスクを実行し、タスク実行中にサーバからの出力を表示します。Executionサーバ上の特定タスク実行前に、確認のプロンプトを出したい場合は、タスク宣言でconfirmディレクティブを追加してください。このオプションは、破壊的な操作を行う場合に特に便利です。migrate@endtask通知NotificationsSlackSlackEnvoyは各タスク実行後の、Slackへの通知もサポートしています。@slackディレクティブは、SlackフックURLとチャンネル名を引数に取ります。WebHooks"統合を作成することにより、作成されます。WebフックURL全体を@slackディレクティブへ渡してください。'#bots')@endfinishedチャンネル引数には以下のどちらかを指定します。`@user`DiscordDiscordEnvoyは各タスク実行後の、Discordへの通知もサポートしています。@discordディレクティブは、DiscordフックURLとメッセージを引数に取ります。Settingで"Webhook"を作成し、どのチャンネルにポストするのかを選べば、WebフックURLが取得できます。WebフックURL全体を@discodeディレクティブへ渡してください。2019.ドキュメントメンテナンス期間は終了しました。明暗テーマごとに、コードハイライトのテーマを指定できます。テーマ配色確認スクリーン表示幅640px80%90%100%768px以上の幅があるときのドキュメント部分表示幅です。段落末のEボタンへカーソルオンで原文をPopupします。[tl!...]形式の挿入削除行の表示形式です。置換文字列を半角スペースで区切ってください。(最大5組各10文字まで)本文フォント総称名以外はCSSと同様に、"〜"でエスケープしてください。コードフォント総称名以外はCSSと同様に、"〜"でエスケープしてください。保存内容リセット消去localStrageに保存してある設定項目をすべて削除し、デフォルト状態へ戻します。