php からサーバコマンドを実行する方法。

公式：exec、system

php からサーバコマンドを実行するには
exec と system の２つの関数が用意されている。

二者の違いは、出力を返すか返さないかみたいだけど
引数指定次第でどちらも出力を返すみたいなので
結果的には、同じ働きなのかしらね～。

string exec ( string $command [, array &$output [, int &$return_var ]] )

第1引数：コマンド文字列
第2引数：出力格納用変数。省略可。省略すると出力を受け取れない
第3引数：コマンド実行結果ステータス格納用変数。省略可。省略するとステータスを受け取れない

string system ( string $command [, int &$return_var ] )

第1引数：コマンド文字列
第2引数：コマンド実行結果ステータス格納用変数。省略可。省略するとステータスを受け取れない

どちらもコマンド文字列に「 > /dev/null &」と付記してやることで、非同期に処理を実行できる。

注意:

プログラムがこの関数で始まる場合、 バックグラウンドで処理を続けさせるには、
プログラムの出力をファイルや別の出力ストリームにリダイレクトする必要があります。
そうしないと、プログラムが実行を終えるまで PHP はハングしてしまいます。

どうやら、上記付記内容は、出力をリダイレクトさせるものらしい。

SAMURAI：【PHP入門】外部コマンドの実行(exec)とコマンドライン実行の方法（2017-10-16）

個人で開発をしていると、こういうチームワーク的な手法に手が回らない。
実感が湧かないからね。。。

公式？：phpDocumentor

公式？：@property
メンバ変数の型宣言をできる。

php では、メンバ変数を宣言する際に、型宣言を伴わない。
そのせいで phpStrom では、警告が出るらしい。

class User
{
    private $name;

    public function getName()
    {
        return $this->name;
    }

    public function setName($name)
    {
        $this->name = $name;
    }
}

この User クラスをメンバ変数 $leader へ代入すると
$leader が何者か不明なために、User クラス内メソッドを利用する際に警告となるらしい。

そこで、下記のように @property アノテーションで定義してやることで
理解してもらえるそうな。

ちなみに、複数管理するメンバ変数には、User[] という他言語タイプで伝えるとよいらしい。

/**
 * Class Group
 *
 * @property User $leader
 * @property User[] $leaders <- array ではなく User[]
 */
class Group
{
    private $leader;
    private $leaders = [];
}

公式？：@method
findX のようなマジックメソッド利用時に用いる。
※マジックメソッドは、そんなメソッドは存在しないんだけど
メソッド名からフレームワーク側が解析して、処理してくれるメソッド？

/**
 * Class SampleModel
 *
 * @method array findById($id, $fields = null)
 */
class SampleModel extends AppModel
{

このように明記してやることができる。

メソッド名を動的に生成する場合に用いる。
要は、当該メソッドがどこからも呼ばれていないと思われるのを避ける。

公式？：@uses & @used-by

class Hoge
{
    /**
     * @uses addUser(), addAdmin()
     */
    public function addMember($user, $user_type)
    {
        $method = sprintf('add%s', $user_type);
        $this->{$method}($user); // $user_type に合ったメソッドを呼ぶ
    }

    /**
     * @used-by addMember
     */
    private function addUser($user)
    {
    }

    /**
     * @used-by addMember
     */
    private function addAdmin($user)
    {
    }
}

@uses の呼び出し元に設定する。

@uses の呼び出し先に設定する。

バシャログ。：PhpStorm の静的解析機能をさらに活用するための3つのアノテーション（2015-12-07）
→@property, @method, @uses について非常にわかりやすかった

.editorconfig に対応するためのプラグイン。

CakePHP3 の コーディング規約 を調べていたら
.editorconfig なるものの存在を知った。

これを Eclipse で利用できるようになるプラグイン。

[ヘルプ]-[Eclipse マーケットプレース]
検索窓に「editorconfig」
「editorconfig-eclipse 0.x」がヒットするので [インストール]
ライセンスに同意して [完了]

がーん。。。断念。 😥

後述するけど、Composer は root では使わない方がよいそうなので
一般ユーザで操作。

そのため、先にroot でディレクトリを作成して
パーミッションを設定しておく必要がある。

mkdir /var/www/my_app
cd /var/www
chown apache:[username] my_app
chmod 775 my_app

1. ディレクトリ作成
2. ディレクトリ移動
3. 所有者変更
4. パーミッションを設定

一般ユーザへ変更してから。

composer create-project --prefer-dist cakephp/app /var/www/my_app

アプリ名を指定せず、下記のように実行すると

composer create-project --prefer-dist cakephp/app

app ディレクトリが自動生成されて、その中にインストールされる。

root でインストールをしようとすると、下記警告が出る。

composer create-project --prefer-dist cakephp/app /var/www/my_app
Do not run Composer as root/super user! See https://getcomposer.org/root for details

上記コマンドにてインストールをしようとしたところ
下記例外が投げられた。

Google 先生に質問し、１つ目の対応。
下記参考サイトによると、composer の健康診断コマンドらしい。

参考サイトの内容とは異なるけど、まずは診断。

composer diag
Checking platform settings: OK
Checking git settings: OK
Checking http connectivity to packagist: OK
Checking https connectivity to packagist: OK
Checking github.com rate limit: OK
Checking disk free space: OK
Checking pubkeys:
Tags Public Key Fingerprint: 57815BA2 7E54DC31 7ECC7CC5 573090D0  87719BA6 8F3BB723 4E5D42D0 84A14642
Dev Public Key Fingerprint: 4AC45767 E5EC2265 2F0C1167 CBBB8A2B  0C708369 153E328C AD90147D AFE50952
OK
Checking composer version: OK
Composer version: 1.6.2
PHP version: 7.1.13
PHP binary path: /usr/bin/php

問題ないみたい。

ふたりはララベル：Composerのエラーの原因を調査する（2014-08-23）

下記参考サイトを見つけて、わけもわからないまま対応。

wget http://curl.haxx.se/ca/cacert.pem
cp -v -f cacert.pem /etc/pki/tls/certs/ca-bundle-curl.crt

1. OpenSSL(正確にはcurl)で使用するCAをダウンロード
2. 当該ファイルを、本家（？）ca-bundle.crt の存在するディレクトリへコピー

注意事項

このcrtファイルはcurlのエラーを回避するためのものですので、本来のca-bundle.crtを上書きしないように注意して下さい。

Qiita：ComposerからLaravelを導入しようとしてOpenSSL周りのエラーで困った件（2015-06-23）

php.ini へ上記ファイルを設定

vim /etc/php.ini

curl.cainfo=/etc/pki/tls/certs/ca-bundle-curl.crt
openssl.cafile=/etc/pki/tls/certs/ca-bundle-curl.crt

最初コピペで作業をして、下記のように怒られた。

cp -v -f cacert.pem /full/path/to/certs/ca-bundle-curl.crt
`cacert.pem' -> `/full/path/to/certs/ca-bundle-curl.crt'
cp: 通常ファイル `/full/path/to/certs/ca-bundle-curl.crt' を作成できません: そのようなファイルやディレクトリはありません

そりゃ、/full/path/to は見つからなくて怒られるよねｗ

でも、コピー先のディレクトリがわからなかったので、
注意書きに書かれていた ca-bundle.crt ファイルを検索。

find / -name 'ca-bundle.crt'
/etc/pki/tls/certs/ca-bundle.crt

Qiita：ComposerからLaravelを導入しようとしてOpenSSL周りのエラーで困った件（2015-06-23）

上記「対応２」で解決！
ありがたや～。

curl -sS https://getcomposer.org/installer | php
All settings correct for using Composer
Downloading...

Composer (version 1.6.2) successfully installed to: /root/composer.phar
Use it: php composer.phar

php composer.phar
Do not run Composer as root/super user! See https://getcomposer.org/root for details
   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.6.2 2018-01-05 15:28:41

Usage:
  command [options] [arguments]

Options:
  -h, --help                     Display this help message
  -q, --quiet                    Do not output any message
  -V, --version                  Display this application version
      --ansi                     Force ANSI output
      --no-ansi                  Disable ANSI output
  -n, --no-interaction           Do not ask any interactive question
      --profile                  Display timing and memory usage information
      --no-plugins               Whether to disable plugins.
  -d, --working-dir=WORKING-DIR  If specified, use the given directory as working directory.
  -v|vv|vvv, --verbose           Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
  about                Shows the short information about Composer.
  archive              Creates an archive of this composer package.
  browse               Opens the package's repository URL or homepage in your browser.
  check-platform-reqs  Check that platform requirements are satisfied.
  clear-cache          Clears composer's internal package cache.
  clearcache           Clears composer's internal package cache.
  config               Sets config options.
  create-project       Creates new project from a package into given directory.
  depends              Shows which packages cause the given package to be installed.
  diagnose             Diagnoses the system to identify common errors.
  dump-autoload        Dumps the autoloader.
  dumpautoload         Dumps the autoloader.
  exec                 Executes a vendored binary/script.
  global               Allows running commands in the global composer dir ($COMPOSER_HOME).
  help                 Displays help for a command
  home                 Opens the package's repository URL or homepage in your browser.
  info                 Shows information about packages.
  init                 Creates a basic composer.json file in current directory.
  install              Installs the project dependencies from the composer.lock file if present, or falls back on the composer.json.
  licenses             Shows information about licenses of dependencies.
  list                 Lists commands
  outdated             Shows a list of installed packages that have updates available, including their latest version.
  prohibits            Shows which packages prevent the given package from being installed.
  remove               Removes a package from the require or require-dev.
  require              Adds required packages to your composer.json and installs them.
  run-script           Runs the scripts defined in composer.json.
  search               Searches for packages.
  self-update          Updates composer.phar to the latest version.
  selfupdate           Updates composer.phar to the latest version.
  show                 Shows information about packages.
  status               Shows a list of locally modified packages.
  suggests             Shows package suggestions.
  update               Upgrades your dependencies to the latest version according to composer.json, and updates the composer.lock file.
  upgrade              Upgrades your dependencies to the latest version according to composer.json, and updates the composer.lock file.
  validate             Validates a composer.json and composer.lock.
  why                  Shows which packages cause the given package to be installed.
  why-not              Shows which packages prevent the given package from being installed.

mv composer.phar /usr/local/bin/composer

これで、直接 composer で利用できる。

実は上記インストール時に、下記２行目の警告が出ていた。

curl -sS https://getcomposer.org/installer | php
PHP Warning:  Module 'intl' already loaded in Unknown on line 0
All settings correct for using Composer
Downloading...

Composer (version 1.6.2) successfully installed to: /root/composer.phar
Use it: php composer.phar

これは、php.ini で extension=intl.so をコメントアウトすることで消えたけど
CakePHP3 をインストールする際に intl は必要なはずなので、後ほど試す。

実は上記起動時に、下記２行目の警告が出ていた。

php composer.phar
Do not run Composer as root/super user! See https://getcomposer.org/root for details

あら、Composer って、root で利用してはいけないのね～。

実行ファイルを移動させて、一般ユーザに戻って利用したら
上記警告は出なくなった。

ちなみに、インストールを root でしたせいか
実行ファイルを移動しておかないと、php composer.phar では、実行できず

php composer.phar
Could not open input file: composer.phar

このように怒られた。。。

WinRoad徒然草：さくらのVPSサーバーにLaravelのインストール（2015-03-23）

DQL における、結果セットの整形。
Data Hydrators

execute, fetchOne, fetchAll などの第２引数に指定する。

レコードをオブジェクトとして取得。
デフォルト値なので、省略すればこれになる。

連想配列として取得。

連想配列として取得。
キーが、カラム名_フィールド名 という書式になっている。

配列として取得。
WHERE 句で指定したカラムの値を、
添え字 0 から始まる配列の要素に格納（しているように見える）。

公式サイトを読む限り、
「１レコードしか読み込まないのでメモリを節約できるよ」
って書いてある気がするけど
実験したら、時間制限に引っ掛かって戻ってこなかったので
今回はパス。

nested ビヘイビアを利用しているときに使える引数っぽい。
オブジェクトとして取得。

nested ビヘイビアを利用しているときに使える引数っぽい。
連想配列として取得。

配列として取得。
取得してきたデータを、添え字 0 から始まる配列の要素に格納（しているように見える）。

連想配列として取得。
SELECT で指定したカラムだけを取得。

※下２つは、下記参考サイトから拾ってきた。
公式サイトに全種類が載っていないのは不思議・・・

上記定数を参考に、こんなのもあるかと思ったけどなかったｗ

stackoverflow：Select One column Doctrine DQL（2013-01-19）

なが～い文字列を扱うための構文。

PHP Manual：文字列　ヒアドキュメント

WordPress なのか iG:Syntax Hiliter なのか
<<< という記述をすると、表示が乱れるので <<< と表記してある。 でも、最後のコード表記は大丈夫なのよね～・・・。

ヒアドキュメントを識別するためのもの。
上記例では、EOD が該当する。

• 英数字およびアンダースコアのみ
• 数字でない文字またはアンダースコアで始まる必要がある
• 終端 ID がある行には、セミコロン (;) 以外の他の文字が含まれていてはならない
• ID はインデントしてはならない
• セミコロンの前に空白やタブを付けてはいけない
• 終端 ID の前の最初の文字は、使用するオペレーティングシステムで定義された 改行である必要がある
• 最後の区切り文字の後にもまた、改行を入れる必要がある

よく上記のようなスクリプトを見かけるけど
最後の ;（セミコロン）は、あくまでも $foo = に対するものであって
ヒアドキュメントとは関係ない。

つまり、下記のように記述すればイメージしやすい。

変数は、そのまま記述すればパースされる。

PHP Manual：文字列　変数のパース
これを読んでも、「簡単」と「複雑」の定義がはっきりしないので
全て {}（波括弧、中括弧）を付けるほうが安全かも？

定数や関数は $（ドル）から始まらないので、処理不能・・・？

最初に Google 先生に質問したら、
「定数や関数は使えない」という回答ばっかり引っかかってきたけど
２回目の質問では、アッサリと解決策が。
Blog：PHPのヒアドキュメント内で定数や関数を動かす
Web、ときどきDTP。（うぇヴ(web)屋のネタ帳。）：PHPのヒアドキュメント内で関数を使う。計算もしたい。

クラスを用意して、そのメンバ変数やメソッドとして利用する。

定数は、そのまま変数にしてしまえばよい。
関数は、可変変数を用いて処理。

直接出力しても

変数に代入してもよい。

PHP 5.3.0 以降の機能。

ヒアドキュメントはダブルクォーテーションで括られた文字列として扱われるのに対して
Nowdoc は、シングルクォーテーションで括られた文字列として扱われる。

中身について、パース処理を行わないので、エスケープをする必要がなくなる。
SGML の

開始 ID を、シングルクォーテーションで括る。

すたら日記：PHP ヒアドキュメントの使い方：2通り

array_column は、連想配列群の中から、単一カラムを取り出して配列で返してくれる。

レコードセットのように、同型の連想配列が連番で格納されているような配列において
各レコードから特定のカラムの値だけを抽出する。

array array_column ( array $input , mixed $column_key [, mixed $index_key = null ] )

php：array_column

第１引数：元配列
第２引数：抽出したいカラム名
第３引数：抽出後キーにしたいカラム名。省略可

PHP 5.5 から新しく加わった関数。

残念！
私は 5.4.7 だった＞＜

がっかりポンだ～と思っていたら
代替というか、GitHub：array_column/src/array_column.php で関数が提供されていた。
ありがとうございます！

ファイルに保存して、インクルードパスへ配置して
require して、見事動作しました♪

注意書きを見つけたのでメモ。

Qiita：DoctrineのDISTINCTは正しく動作しない
→回避策あり

Qiita：DoctrineのLEFT JOINはまともに使えない
→回避策あり

既存データの更新をしようとして起きた。

ちょこっといじったら、エラー内容が下記に変わったけど、エラー内容はほぼ同じ？

既存データとセーブデータの ID（プライマリーキー）が被ってるよ、という警告のまんま。

フォームを利用しているものの、Ajax 通信であったため、フォームをそのまま突っ込むのではなく
手動でデータをセットして保存しようとしていた。

Symfony（Doctrine）では、save メソッドで、INSERT と UPDATE を自動判別してくれるとのことで
INSERT のときと、同じデータのセットの仕方にしていたけど
これがいけなかったみたい。

後述の通り、事前にフォームにデフォルト値を設定することで
エラーは消えた。

フォーム -> 表示（Model 有り） にあるように

とすることで、フォームのデフォルト値（既存データ）がセットされ
これによって、INSERT と UPDATE を自動判別しているっぽい。