Visual Studio Codeには標準でコードの整形機能（フォーマッター）がついているが、デフォルトではhtmlやjavascriptなどしか整形してくれない。PHPのフォーマッターは別途自分で拡張機能から導入する必要がある。尚、以下の解説環境はUbuntu。

## php cs fixerのインストール

[php cs fixer](https://marketplace.visualstudio.com/items?itemName=junstyle.php-cs-fixer)というフォーマッターを導入する。シンプルであまり設定することもないので簡単。[vscode-php-formatter](https://github.com/Dickurt/vscode-php-formatter)というのもあるのだけど、こっちは自分の環境だと動作しなかった。

VSCで`Ctrl+P`から`ext install php-cs-fixer`を入力し、拡張をインストールする。

## PHP Coding Standards Fixerの導入

このアドオンは[PHP Coding Standards Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer)に依存しているので、これをインストールする必要がある。composerからでも入れられるが、自分は手動インストールを行った。

```bash
curl -L http://cs.sensiolabs.org/download/php-cs-fixer-v2.phar -o php-cs-fixer
sudo chmod a+x php-cs-fixer
sudo mv php-cs-fixer /usr/local/bin/php-cs-fixer
```

## php cs fixerの設定と使い方

特に必須設定はないが、触るとすれば以下。

```bash
// フォーマットレベル(@PSR1, @PSR2, @Symfonyがある)
"php-cs-fixer.rules": "@PSR2",

// ファイル保存時にフィルタを自動で行う（デフォルトはfalse）
"php-cs-fixer.onsave": true,

// PHPファイルに含まれているHTMLも同時に整形する
"php-cs-fixer.formatHtml": false
```

上記設定でファイル保存時に自動整形してくれる。もし手動でフォーマットしたい場合は、右クリックからFormat Document（全体）やFormat Selection（選択部分）で行える。

尚、ショートカットキーはOSごとで異なるので注意。

> Windows: Shift + Alt + F Mac: Shift + Option + F Linux: Ctrl + Shift + I

これらもキーボードのショートカット設定から`{ "key": "ctrl+k ctrl+d", "command": "editor.action.formatDocument" }`のように変更もできる。

VSCodeのPHPフォーマッターの設定。

Visual Studio CodeでPHPのフォーマッター

`htmlspecialchars`で変換される内容は、`get_html_translation_table`で得られる**変換テーブル**で取得できる。以下は`ENT_QUOTES`の場合。

```php
$table = get_html_translation_table(HTML_SPECIALCHARS, ENT_QUOTES);
var_dump($table);

array(5) {
  ["""]=>
  string(6) """
  ["&"]=>
  string(5) "&"
  ["'"]=>
  string(6) "'"
  ["<"]=>
  string(4) "<"
  [">"]=>
  string(4) ">"
}
```

ここに条件を加えると、`htmlspecialchars`の変換条件を増やすことができる。例えば`ENT_QUOTES`をオプションに与えたとき、空白文字もエンコードしたい場合は以下になる。

```php
$h = htmlspecialchars('hello world', ENT_QUOTES, "UTF-8");
$table = get_html_translation_table(HTML_SPECIALCHARS, ENT_QUOTES);
$table[' '] = '&nbsp;';
$encode = strtr($h, $table);

// string(84) "&lt;p id=&quot;test&quot;&gt;hello&nbsp;world&lt;/p&gt;"
var_dump($encode);
```

このように挙動を多少変えることができる。

htmlspecialcharsの変換条件を増やす。

htmlspecialcharsの変換条件を増やす

Vagrantのrsyncについて調べてみた。手探りゆえ間違ったことを書いている可能性あり。

## 通常同期（Virtualbox）

まずrsyncの前に通常同期（basic）に触れる。

通常同期のとき同期するファイル・ディレクトリのユーザ/グループ及びパーミッションは以下のように設定できる。

```bash
## 例1 ##
config.vm.synced_folder "../workspace", "/home/vagrant/html", 
mount_options: ['dmode=775','fmode=644'], owner: "apache", group: "apache" 
```

## rsync

rsyncには`rsync__chonw`というオプションがあり、これが割と曲者。

値となるture, falseで違いを見ていく。

### rsync(rsync\_\_chown: true)

通常`rsync__chown`はtrueになっており、一括chown(`chown -R`)が行われ、Vagrant:Vagrantで上書きされる。 パーミッションはホストから独立しているので、自由に設定できる。

```bash
## 例2 ##
config.vm.synced_folder "../workspace", "/home/vagrant/html",
type: "rsync",
rsync__exclude: [".git/", "vendor/"],
rsync__chown: true
```

[rsync](https://www.vagrantup.com/docs/synced-folders/rsync.html)には記載されていないが、`owner`と`group`オプションはなぜか使える。ただし、`mount_options`は使えない模様。

このオプションを使うと、同期ファイルのユーザとグループが指定できる。

```bash
## 例3 ##
config.vm.synced_folder "../workspace", "/home/vagrant/html",
type: "rsync",
rsync__exclude: [".git/", "vendor/"],
owner: "apache",
group: "apache",
rsync__chown: true
```

更に通常同期のように同期ファイルのパーミッションを設定したいというときは、`rsync__args`の引数に`--chmod`を与えると設定ができる。

```bash
## 例4 ##
config.vm.synced_folder "../workspace", "/home/vagrant/html",
type: "rsync",
rsync__exclude: [".git/", "vendor/"],
owner: "apache",
group: "apache",
rsync__args: [
    "--compress", "--verbose", "--archive", "--delete", "--copy-links",
    "--chmod=Du=rwx,Dgo=rx,Fu=rw,Fog=r", # D755 F644
],
rsync__chown: true
```

尚、`--chmod`を指定するときは、`--perms, -p`を指定しないと無視されてしまうので注意。

上は`--archive`_`-rlptgoD` と同義_を設定しているため問題はない。

> \-r, --recursive: ディレクトリを再帰的にコピー -l, --links: シンボリックリンクを作り直す -p, --perms: コピー先のパーミッションをコピー元と同じにする -t, --times: 修正時間情報も転送する -g, --group: 所有者のグループを送信元と同じにする -o, --owner: 所有者を送信元と同じにする -D: デバイスファイルを維持

### rsync(rsync\_\_chown: false)

同期時に`chown -R`を止めるオプション。

```bash
## 例5 ##
config.vm.synced_folder "../workspace", "/home/vagrant/html",
type: "rsync",
rsync__exclude: [".git/", "vendor/"],
rsync__chown: false,
```

この場合、ホストから新規で追加されるファイルはroot:rootとなる。 また、既存ファイルは作成されたときのままのオーナー:グループとなっていた。 勿論、`rsync__false`の場合でも先のように`rsync__args`の各オプションは設定可能。

```bash
## 例6 ##
config.vm.synced_folder "../workspace", "/home/vagrant/html",
type: "rsync",
rsync__exclude: [".git/", "vendor/"],
rsync__args: [
    "--verbose", "--archive", "--delete", "-z", "--copy-links",
    "--chmod=Du=rwx,Dgo=rx,Fu=rw,Fog=r", # D755 F644
    "--owner", "--group", # required for the following command
    "--usermap=*:apache", "--groupmap=*:apache"
],
rsync__chown: false
```

例6の解説になるが、`rsync__args`の第1,2引数は前回と同じ。

第4引数の`--usermap`と`--gruopmap`は、同期時にオーナーとグループをマッピングする機能。 これらのオプションを指定するには、第3引数の`--owner`と`--group`の設定_`--archive`で`-o`と`-g`は含まれているはずだが、自分の環境では明示的に記述しないと機能しなかった_が必要。

また`--usermap`と同じ機能を持つオプションとして、`--chown=USER:GRUOP`というものもある。 これは内部的には`--owner`と`--group`を使っているため、`--chown`と`--usermap`を混合させることはできない。

つまり`--chown=foo:bar`は、`--usermap=*:foo --gruopmap=*:var`と同義。

この機能はマップされるユーザが同期元と先で異なる場合に役立つ。

そして、例6は結局のところ例4と同じ同期状態を提供することになる。

#### 一部オプションを使うとエラーになる場合

上に書いた例を試してエラーになる場合は、`rsync`のバージョンを疑うといい。

通常、`rsync`はホスト/ゲストともに入れる必要がある。Windowsの場合はCygwinを使うことがほとんどだと思うので、最新の`rsync`が導入される。問題はゲスト側。

ゲストに`rsync`コマンドが導入されていない場合は、Vagrantでマシン立ち上げ時に自動でインストール_yum -y install rsync_が行われているが、標準のリポジトリの`rsync`は古い。

例えばCentOS 6.8_\--enablerepo=base_だとver 3.0.6がインストールされたが、3.0.6だと上に書いた`usermap`なんかは使えない。

#### 最新バージョンをインストール

以下、トラブったときのためにboxのバックアップをとってからやるべし。

Vagrantfileから共有フォルダの設定部分をコメントアウトしマシンを起動する。

```bash
vagrant reload
vagrant ssh
su -
yum remove rsync
wget https://www.samba.org/ftp/rsync/src/rsync-3.1.2.tar.gz
tar xzvf rsync-3.1.2.tar.gz
rm -f rsync-3.1.2.tar.gz
cd rsync-3.1.2
./configure
make
make install
reboot -h now
rsync --version
rsync  version 3.1.2  protocol version 31
```

バイナリから入れると、/usr/local/bin/rsyncに配置された。 そして、新しい`rsync`を入れた場合はその位置を`rsync__rsync_path`で指定する必要がある。

つまり例6を元に書くと、こんな感じになる。

```bash
config.vm.synced_folder "../workspace", "/home/vagrant/html",
type: "rsync",
rsync__exclude: [".git/", "vendor/"],
rsync__args: [
    "--compress", "--verbose", "--archive", "--delete", "--copy-links",
    "--chmod=Du=rwx,Dgo=rx,Fu=rw,Fog=r", # D755 F644
    "--owner", "--group", # required for the following command
    "--usermap=*:apache", "--groupmap=*:apache"
],
rsync__chown: false,
rsync__rsync_path: "sudo /usr/local/bin/rsync"
```

パスに`sudo`が入っているけども、自分の環境の場合つけないと赤文字が出るのでこうしている。

以上、rsyncで1週間半ほど躓いた内容の一部をまとめてみました。

Vagrantのrsyncについて調べてみた。

Vagrant rsync 奮闘記

Vagrantの同期タイプを今更ながらrsyncに変えた。rsyncの設定自体は簡単だが、その前段階の周辺環境の設定でトラブってたのでメモ。

> rsyncの利点
> 
> - 同期が速い
> - ゲスト側のパーミッションを自由に変更できる
> 
> rsyncの欠点
> 
> - 自動同期させるのにコマンドが必要
> - 同期はホストからゲストへの一方方向のみ

欠点の2つ目が問題になることある。

例えば（自分の場合）、ゲストにComposerをグローバルインストールしてライブラリを揃えていた場合、このファイルがホストには見えない。

そこでまずはホストにComposerを入れるところから始める。

## PHPのインストール

ホストにPHPも入っていなかったので、先に入れておいた。

DLしたzipをC:\\phpで配置し、php.iniの記述とシステム環境変数にPathを通すだけ。

ちなみにこの後にCygwinを入れるため、そこでPHPのパッケージを選択するのが一番簡単。

しかし、自分の場合Composerが一部コマンドで`cygwin segmentation fault (core dumped)`を吐いてしまい前に進めなかったため、今回はWindow純正で入れることにした。

## Cygwin

[公式サイト](https://www.cygwin.com/)からインストーラーをDLし、実行。パッケージは以下を選択。

- rsync
- openssh
- vim-Vi IMproved
- wget
- bash
- zip
- unzip
- git
- curl

CygwinでPHP+Composerを入れるなら以下のパッケージを入れる必要がある。

- php
- php-mbstring
- php-intl
- php-phar
- php-json
- php-zlib

### 初期起動

最初に起動するとホームに.bashrcなどが書き出される。

```bash
They will never be overwritten nor automatically updated.

'./.bashrc' -> '/home/maeda//.bashrc'
'./.bash_profile' -> '/home/am//.bash_profile'
'./.inputrc' -> '/home/maeda//.inputrc'
'./.profile' -> '/home/maeda//.profile'
```

ウィンドウの左上をクリックするとOptionsを開けるので、そこで好みの設定を行う。

最低限、TextでLocale:ja\_JP, Character set: UTF-8にしておくといい。

### 環境設定

CygwinのホームディレクトリはWindowsとマッチしておらず気持ち悪いので、これを合わせる。

Cygwin64\\etc\\fstabを開き、以下を末尾に追加する。

```bash
C:/Users/ /home/ ntfs  override,binary,auto 0 0
```

### シェル設定

自身のホームに以下のファイルを作成・配置する。先程初期起動時に書き出されたファイルをそのままコピーして編集するのがベター。

.bash\_profileを開き以下を設定。

```bash
if [ -n "${BASH_VERSION}" ]; then
  if [ -f "${HOME}/.bashrc" ]; then
    source "${HOME}/.bashrc"
  fi
fi

if [ -d "${HOME}/bin" ] ; then
  PATH="${HOME}/bin:${PATH}"
fi
```

.bashrcに以下を追加

```bash
# 文字コード
export LANG=ja_JP.UTF-8
export LC_ALL=ja_JP.UTF-8

# プロンプト文字列の設定
export PS1="\[\e[36;1m\][@\h \w]\$\[\e[m\] "
```

.vimrcを配置（cygwin64\\etc\\vimrcに雛形アリ）

```bash
"文字コードをUFT-8に設定
set fenc=utf-8
" バックアップファイルを作らない
set nobackup
" スワップファイルを作らない
set noswapfile
" 入力中のコマンドをステータスに表示する
set showcmd

" 行番号を表示
set number
" 括弧入力時の対応する括弧を表示
set showmatch
" コマンドラインの補完
set wildmode=list:longest

" Tab文字を半角スペースにする
set expandtab
" 行頭以外のTab文字の表示幅
set tabstop=2
" 行頭でのTab文字の表示幅
set shiftwidth=2
" 検索語をハイライト表示
set hlsearch
```

### Composer

```bash
cd ~
curl -sS https://getcomposer.org/installer | php
# 後の作業のため.pharはつけたままとする
mv composer.phar /usr/local/bin/
chmod +x /usr/local/bin/composer.phar
```

上記の場合、例えば`php composer.phar require twig/twig`としても、Windows（PHP）が**Unix向けのパスを解決できない**ため実行できない。

composrをプロジェクトディレクトリに置いた場合（ローカルインストール）は可。

そこでComposerコマンドを解決できるように.bashrcにエイリアスを作成する。

```bash
alias composer='php C:\\cygwin64\\usr\\local\\bin\\composer.phar'
```

## Cmder

Cygwinに結合されているminttyはタブ機能がないので、もし必要なら[Cmder](http://cmder.net/)を入れるといい。

サイトから最小バージョンをDLして、好きな場所に展開し一度起動。

Option>Startup>Tasksで「+」を押しCygwinを追加。

Default task for new console, Taskvar jump lists, Default shellをチェックし、下のCommandのボックスに以下を入力。

```bash
C:\cygwin64\Cygwin.bat -cur_console:a -cur_console:d:C:\cmder {cygwin}
```

StartupのオプションでSpecified named taskで{cygwin}を選択する。

## Vagrant\_rsync

vagrantfileに`type: "rsync"`と記述すれば、あとは通常の同期と同じように利用できる。

```bash
vagrant up
vagrant rsync-auto
# 別のターミナル起動
vagrant ssh
```

デフォルトでは`rsync__chown`はtrue。ファイル同期の際にvagrantで一括chownされる。これが嫌ならばfalseを設定すればいい。

また、rsyncのオプションは`rsync__args`で設定できる。

VagrantとrsyncとCygwin周辺の設定メモ。