refirio.org

Memo

メモ > サーバ > 各論: プログラミング > PHPでComposerを使う

PHPでComposerを使う
PHPの依存性管理ツール 依存ライブラリ郡も含めて、まとめてインストールできる
composer require 使いたいライブラリ
もしくは、composer.json に使いたいライブラリを記述して
composer install
とコマンドを実行するとインストールされる 自分で一つ一つ依存ライブラリをダウンロードする必要が無い ダウンロードしたファイルは vendor フォルダ内に格納される PHP開発でComposerを使わないなんてありえない！基礎編 - Qiita http://qiita.com/niisan-tokyo/items/8cccec88d45f38171c94 Laravel5のプロジェクトをGitで管理する - Qiita https://qiita.com/zaburo/items/bc448a9fbf2d35194302 php - vendorディレクトリをGit管理下に置かないのは何故？ - スタック・オーバーフロー https://ja.stackoverflow.com/questions/23725/vendor%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%... CentOS7にComposerをインストールする - Qiita https://qiita.com/inakadegaebal/items/d370bcb1627fce2b5cd1 Composer を CentOS にインストールする手順 | WEB ARCH LABO https://weblabo.oscasierra.net/php-composer-centos-install/ ■インストール
# php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" # php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" # php composer-setup.php # php -r "unlink('composer-setup.php');" # php composer.phar
ハッシュの値はバージョンによって異なるため、最新の手順は以下で確認する https://getcomposer.org/download/ この際、
All settings correct for using Composer Unable to create Composer home directory "/usr/share/httpd/.config/composer": mkdir(): Permission denied
と表示されるなら、rootで以下を実行しておく（もしくは apache を所有者とするディレクトリを作成するか）
# cd /usr/share/httpd # mkdir .config # cd .config # mkdir composer # chmod 0777 composer
Composerをどこからでも呼び出せるようにする場合、以下も実行する
# mv composer.phar /usr/local/bin/composer
以下のように、パスも拡張子も無しで呼び出せる
# composer
■コマンド例 バージョンを表示（Composerの動作確認）
$ composer
ライブラリのインストール（Goutteをインストールする場合）
$ composer require fabpot/goutte
各ライブラリを最新に更新（プログラムの動作に影響する可能性があるので慎重に）
$ composer update
composer.json に書かれたライブラリとバージョンに従って更新（他環境で更新された場合など）
$ composer install
以下のようにすると、開発用ツールを除いてインストールされる（本番環境などでは、この方法でインストールするといい）
$ composer install --no-dev
インストールに失敗して原因が不明な場合、以下のように composer.lock を退避してから実行すれば成功することがある（ただし恐らく非推奨）
$ mv composer.lock composer.20200513.lock $ composer install --no-dev
「--no-dev」の指定については、以下などが参考になる 【Laravel】composer require-devの開発、本番での切り分け - Qiita https://qiita.com/k-kurikuri/items/8e644b3338d8759d64fd PHP |【パッケージ管理】Composerの使い方 - わくわくBank https://www.wakuwakubank.com/posts/415-php-composer/ ■オートローディング 名前空間に従って自動的にファイルを読み込む require_once などで明示的にファイルを読み込む必要がない Composerを使うことで簡単に導入できる PHPでクラスをspl_autoload_registerを使ってオートロードする - バカンス駆動開発 http://egapool.hatenablog.com/entry/2013/11/17/195045 PHPのオートロード(autoload) - Qiita http://qiita.com/atwata/items/5ba72d3d881a81227c2a src/Refirio/Greeting/Hello.php
<?php class Hello { function say() { echo 'Hello World!'; } }
sample.php
<?php require_once "src/Refirio/Greeting/Hello.php"; $hello = new Hello(); echo $hello->say();
↓オートロードに対応させる composer.json
{ "autoload": { "psr-4": { "myapp\\": "src/" } } }
$ composer install … composer.json に設定した内容に合わせて vender ディレクトリ内にプログラムが作られる
以下のようにしてオートロードを利用できる src/Refirio/Greeting/Hello.php
<?php namespace myapp\Refirio\Greeting; class Hello { function say() { echo 'Hello World!'; } }
sample.php
<?php require_once "vendor/autoload.php"; $hello = new myapp\Refirio\Greeting\Hello(); echo $hello->say();
↓名前空間のエイリアスを作成
<?php require_once "vendor/autoload.php"; use myapp\Refirio\Greeting\Hello; //use myapp\Refirio\Greeting\Hello as Hello; // クラスに別名を指定する場合 $hello = new Hello(); echo $hello->say();
■require 新しいパッケージを追加する
$ composer require fabpot/goutte
vendor 内に諸々のプログラムがインストールされる また、composer.json が以下のように変更される composer.json
{ "autoload": { "psr-4": { "myapp\\": "src/" } }, "require": { "fabpot/goutte": "^4.0" } }
goutteが追加されたことを確認 sample.php
<?php require_once 'vendor/autoload.php'; $client = new Goutte\Client(); $crawler = $client->request('GET', 'http://refirio.org/'); $tr = $crawler->filter('ul li')->each(function($element){ echo $element->text()."\n"; });
なお、以下のようにインストールできるパッケージがあったとして、
$ composer require xxx/yyy
以下のようにすることでバージョンを指定してインストールできる
$ composer require xxx/yyy:"4.1.2"
■install composer.lockに書かれている各ライブラリをインストールする
$ composer install
vendor 内に諸々のプログラムがインストールされる ■update composer.jsonをもとに各ファイルを最新版にアップデートする
$ composer update
■composer.json の指定
$ COMPOSER=composer-default.json composer install
とすると、composer.json と composer.lock ではなく composer-default.json と composer-default.lock をもとにインストールが行われる 以下、検証した内容 composer.json と composer.lock のコピーを、それぞれ composer-default.json と composer-default.lock として作成する つまり goutte をインストールできる状態
$ composer require monolog/monolog
monologが追加されたことを確認 sample.php
<?php require_once 'vendor/autoload.php'; use \Monolog\Logger; use \Monolog\Handler\StreamHandler; // ロガー作成 $logger = new Logger('sample'); $logger->pushHandler(new StreamHandler('logs/sample.log', Logger::INFO)); // INFOログ出力 $logger->info('情報ログ'); echo "OK\n";
vendor を削除し、再度以下を実行する
$ composer install
goutte と monolog がインストールされる つまり vendor がなくても composer.json と composer.lock によって環境を再現できた vendor を削除し、今度は以下を実行する
$ COMPOSER=composer-default.json composer install
goutte だけがインストールされる monolog はインストールされない つまり composer-default.json を指定してインストールできた 追加で以下を実行する
$ composer install
monolog が追加インストールされた ■create-project でプロジェクト作成
$ composer create-project ethna/ethna-project
によって、以下が実行されているみたい
$ git clone https://github.com/ethna/ethna-project.git $ cd ethna-project $ composer install
Composerのcreate-projectが何をやっているのか調べてみた - Qiita https://qiita.com/DQNEO/items/74f4bb8fe447e4582a97 ただし自作のリポジトリで create-project をしようとすると以下のエラーになった また詳細を確認したい
$ composer create-project https://github.com/refirio/laravel6 test Creating a "https://github.com/refirio/laravel6" project at "./test" [UnexpectedValueException] Could not parse version constraint //github.com/refirio/laravel6: Invalid version string "//github.com/refirio/laravel6"
■補足 vendor フォルダは通常、gitの管理対象外とする インストールしたライブラリの情報は composer.json と composer.lock に記録され、 「composer install」を実行すると同じバージョンのライブラリをダウンロードしてくれる つまり、他の環境でも同じ状態を再現できる ただし運用方法によっては、vendor をgit管理対象にするのも有効（コマンドラインでの操作が難しい開発メンバーが多い、など） メリット＆デメリットを考える XAMPP環境にインストールする手順は XAMPP.txt を参照

Advertisement