「Composer」の記事 - Crieit

Docker の php:7-alpine イメージで Composer と Xdebug を使えるようにする

2022-05-10T22:39:48+09:00

経緯

slimphp/Slim-Skeleton を利用したいと考えました。

手元の端末で開発しようとしたところ、 XAMPP に Xdebug を入れ忘れていたことに気付きました。しかも、 XAMPP の PHP のバージョンで Xdebug のインストールが止まってしまいました。

そこで、スケルトンプロジェクトに付随している Docker Compose での開発を試みましたが、この Docker Compose 内で pull してくるイメージは Composer も Xdebug もないので入れることにしました。

コード

ディレクトリ構造

root/
    ├ _docker/                               // Dockerに関する設定置き場
    │    ├ dockerfiles/
    │    │    ├ settings/
    │    │    │    └ php.ini                 // PHPの設定 (Xdebug 有効化)
    │    │    │
    │    │    └ Dockerfile
    │    │
    │    ├ mysql/                            // MariaDB 用ディレクトリ
    │    │    └ .gitkeep
    │    │
    │    └ phpmyadmin/
    │         ├ conf/
    │         │    └ phpmyadmin-misc.ini     // phpMyAdmin の設定 (メモリ上限など)
    │         │
    │         └ sessions/
    │              └ .gitkeep
    │
    └ docker-compose.yml

Docker に関する部分のみ列挙。

docker-compose.yml

version: '3.7'

volumes:
    logs:
        driver: local

services:
    slim:
        build:
            context: ./_docker/dockerfiles/
            dockerfile: Dockerfile
        working_dir: /var/www
        command: php -S 0.0.0.0:8080 -t public
        environment:
            docker: "true"
        ports:
            - 8080:8080
        volumes:
            - .:/var/www
            - ./logs:/var/www/logs
    db:
        image: mariadb
        restart: always
        ports:
            - 3306:3306
        volumes:
            - ./_docker/mysql/mysql:/var/lib/mysql
            - ./_docker/mysql/initdb.d:/docker-entrypoint-initdb.d
        environment:
            - MYSQL_ROOT_PASSWORD=pwd
            - MYSQL_DATABASE=test
            - MYSQL_USER=user
            - MYSQL_PASSWORD=pwd
    phpmyadmin:
        image: phpmyadmin/phpmyadmin
        volumes:
            - ./_docker/phpmyadmin/sessions:/sessions
            - ./_docker/phpmyadmin/conf/phpmyadmin-misc.ini:/usr/local/etc/php/conf.d/phpmyadmin-misc.ini
        environment:
            - PMA_ARBITRARY=1
            - PMA_HOST=db
            - PMA_USER=user
            - PMA_PASSWORD=pwd
        ports:
            - 8081:80

変更点は以下。

PHP 用環境: Dockerfile を使ったイメージにカスタマイズ
DB: MariaDB のイメージをそのまま利用
- environment のパラメータはそのまま使用。アプリケーションや phpMyAdmin 側と動機は取れていないですがひとまずはこれで……
phpMyAdmin: これも phpMyAdmin 公式イメージを流用

_docker/dockerfiles/Dockerfile

FROM php:7-alpine
RUN apk --update add curl
RUN set -ex \
  && apk --no-cache add \
  autoconf build-base
RUN pecl install xdebug
RUN docker-php-ext-enable xdebug
RUN docker-php-ext-install pdo_mysql
COPY settings/php.ini /usr/local/etc/php/conf.d
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer

php:7-alpine をベースに Xdebug と Composer を追加。

_docker/dockerfiles/settings/php.ini

xdebug.mode=coverage

Xdebug でカバレッジを有効化するための設定を追加するため。なお、 Dockerfile で COPY する際のホストマシンでのパスは Dockerfile の存在するディレクトリから下でないと参照できない という地味な制約があるので dockerfiles ディレクトリをわざわざ掘りました。

_docker/phpmyadmin/conf/phpmyadmin-misc.ini

allow_url_fopen = Off
max_execution_time = 600
memory_limit = 64M
post_max_size = 64M
upload_max_filesize = 64M

メモリ上限等のカスタマイズ。

これで今回はカバレッジ出力まで動作することを確認しました。

参考

Xdebug

PHPUnitでHTMLコードカバレッジを出すまで(Docker使用) - Qiita

Warning: XDEBUG_MODE=coverage or xdebug.mode=coverage has to be set

が出たので step3 について実施。

なお、今回のケースでは

extension=xdebug.so

は不要だった。

Dockerfile

Dockerで作るNginx + PHP7 + Xdebug環境 | Crudzoo

ほぼこれでOK.

php-alpineコンテナにxdebugをインストールする時にハマったメモ - Qiita

こちらも参照。 php -v で with Xdebug と付いていればOK。

Dockerfile の COPY

【Docker】COPYで指定されたファイルは、Dockerfileが存在するディレクトリからの相対パスで、親ディレクトリを見れない - タカの技術ノート

Mariadb

could not find driver

普通に考えたら確かにドライバがないので追加して解決。

シェル

dockerでalpine linux ベースのcontainerに入って、shellを使いたいとき。 - Qiita

bash ではなく ash 。 bin/ash 指定。

sr -c

docker-compose.ymlのcommandプロパティに複数コマンドを設定する方法 | ゲンゾウ用ポストイット

最終的には使わずに済みましたが念のためメモ。

Composer で処理中にタイムアウトになるのを防ぐ

2022-04-11T23:53:09+09:00

現象

Composer で処理させたところ

The process "'/usr/bin/unzip' -qq '/PATH/TO/PROJECT/vendor/composer/tmp-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' -d '/var
/PATH/TO/PROJECT/vendor/composer/XXXXXXXX'" exceeded the timeout of 300 seconds.

でタイムアウトになってしまったのでこれを防ぐ方法をメモ。

対処

いくつか方法はあるようですが、今回は composer.json に以下の記述を追記することでタイムアウト判定の時間を 300秒(5分) から無制限に変更しました。

"config": {
    "process-timeout": 0
},

これでOK。

参考

lcobucci/jwt を Composer でインストールしようとしたら Your requirements could not be resolved to an installable set of packages. のエラーメッセージ

2021-07-14T20:39:52+09:00

lcobucci/jwt を Composer でインストールしようとしたら以下のエラーメッセージが表示されました。

> composer require
Search for a package: 
./composer.json has been updated
Running composer update 
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires lcobucci/jwt 4.1.4 -> satisfiable by lcobucci/jwt[4.1.4].
    - lcobucci/jwt 4.1.4 requires ext-sodium * -> it is missing from your system. Install or enable PHP's sodium extension.    

To enable extensions, verify that they are enabled in your .ini files:
    - PATH\TO\xampp\php\php.ini
You can also run `php --ini` inside terminal to see which files are used by PHP in CLI mode.

Installation failed, reverting ./composer.json to its original content.

XAMPP (PHP 7.4.3) に ext-sodium の拡張機能がない、と。 Docker を使っても良いのですが、今回はサクッと試したいだけなのでもう少し見てみます。試しに php.ini を確認すると

;extension=soap
;extension=sockets
;extension=sodium
;extension=sqlite3
;extension=tidy
;extension=xmlrpc
;extension=xsl

何かそれらしきものがコメントアウトされているのを発見。

;extension=soap
;extension=sockets
extension=sodium
;extension=sqlite3
;extension=tidy
;extension=xmlrpc
;extension=xsl

コメントアウトを外し、 XAMPP のコントロールパネルから Apache を再起動。

それから再度 Composer でインストールをかけると、正常に完了しました。

参考

lcobucci/jwt - Packagist
同種のエラーメッセージへの対処: 【PHP】「〜requires ext-gd * -> the requested PHP extension gd is missing from your system.」でパッケージがインストールできない時の解決法。 - Qiita

Windows XAMPP 環境で Composer をアップグレードする

2021-07-12T20:48:00+09:00

去年の10月に Composer 2 がリリースされましたが、アップグレードをしてこなかったのでやってみることにしました。

検索して出てきた方法としてコマンドですぐに完了するとのことだったのでコマンドを実行。

> composer self-update --2


  [Symfony\Component\Console\Exception\RuntimeException]  
  The "--2" option does not exist.


self-update [-r|--rollback] [--clean-backups] [--no-progress] [--update-keys] [--stable] [--preview] [--snapshot] [--set-channel-only] [--] []

あれ？

[Symfony\Component\Console\Exception\RuntimeException] The "--2" option does not exist.

エラーになってしまいました。

エラー文で検索したところ以下の記事がヒットしたので、そのコマンド実行。

Composer 2 Update | IMWZ - Bespoke DevOps Work

> composer global update
Changed current directory to C:/Users/USERNAME/AppData/Roaming/Composer
Composer could not find a composer.json file in C:\Users\USERNAME\AppData\Roaming\Composer
To initialize a project, please create a composer.json file as described in the https://getcomposer.org/ "Getting Started" section

自身のユーザ名の下の AppData\Roaming\Composer に composer.json がないと？ Composer の大本の設定のディレクトリですね。

とはいえ、 composer.json の中身をどうすれば良いのか……と思っていたところ、そういえばこの環境はインストーラからインストールしたことを思い出しました。

Composer

ということでおとなしくインストーラをダウンロードし直して実行。

「1つのPCに入れられる Composer は1バージョンのみなので、既存の Composer をアンインストールして」と言われました。

コンパネからアンインストール。 Roaming の設定は一応残しておきます。キャッシュは削除。

アンインストール完了直前に C:\Users\USERNAME\AppData\Local\Composer を手動で削除して、というメッセージが出たので手動削除。先程指定したキャッシュのようですが、アンインストーラから削除できなかったのか……。

アンインストール完了後、再度ダウンロードしたインストーラを実行。後はポチポチしていくだけ。

>composer -v
   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 2.1.3 2021-06-09 16:31:20

インストール完了しました。ひとまずOKそうです。

参考

[Composer] classmapの使い方

2021-06-14T04:20:03+09:00

composerとは

いわずもがな、PHPの標準と言ってもいいパッケージ管理ツールです。インストール方法や使い方はこちらを参照してください。

PHPのライブラリ管理ツール「Composer」入門
 composerとは

こういう人向けの記事です

composer.jsonを書いてライブラリ等を公開したい人向け。利用するだけの人はあまり関係ないかも。

classmapが分からなかった

composerにクラスマップ作ってくれそうな機能ないかなと思って探したらあった。でも使い方がいまいちわからなかったので調査。

classmapの書式

{
    "autoload":{
        "classmap": ["src/", "something.php"]
    }
}

試しにクラスを置いてみる

--- proj_root
       ├ src
       │  ├ MyClassA.php
       │  └ MyClassB.php
       └ MyClassC.php

各クラスの中身はこんな感じ。



composer.jsonはこんな感じ。

{
    ...(省略)...
    "autoload":{
        "classmap": ["src/", "MyClassC.php"]
    }
}


以下のコマンド実行するとオートローダーのクラスマップが生成されます。

composer update


オートローダーのクラスマップ出力先はvendor/composerディレクトリ以下の「autoload_classmap.php」です。

-vendor
  └ composer
       ├ autoload_classmap.php
       └ ...


このファイルの中身はコマンド実行後以下のようになっています。

 $baseDir . '/src/MyClassA.php',
    'MyClassB' => $baseDir . '/src/MyClassB.php',
    'MyClassC' => $baseDir . '/MyClassC.php',
);


$baseDirの中身はプロジェクトのルートディレクトリになります。つまり、クラス名からクラスファイルへのマップ配列（クラスマップ）が設定されたことになります。

classmapはコマンド実行時に生成される固定マップである

クラスマップは対象ディレクトリへクラスファイルを配置した後、composer updateする必要があることがわかります。つまり動的ではありません。

コマンドライブラリやプラグインライブラリのような実行時にならないとクラスファイルが確定しないライブラリの場合上記composerクラスマップでは対応できません。もしくはクラスファイルを配置後、毎回composer updateを実行する必要があるでしょう。

そのような場合は別途自前のクラスローダーを実装するとよいでしょう。

以上、composerのclassmapについてのメモでした。



Wordpressを無料でS3、SendGrid、Heroku、Composerでデプロイする
2018-10-10T19:35:48+09:00


https://github.com/PhilippHeuer/wordpress-heroku

こちらのGithubにある「Deploy to heroku」ボタンをクリックすることでも構築できるのですが、画像やプラグインを永続的に維持するためにはローカルに構築してcomposer updateしてから差分をgit pushし、同じソースコードをherokuにデプロイする必要があるのでした。

いろいろいじってやってみたところ、なんとかできたので、この後もいろいろ試したいと思う。

一番苦労した点は、英語版Wordpressを日本語化する方法だった。

ローカルでWP CLIを使って日本語化ファイルをダウンロードし、git pushしたらできた。

wp core language install ja --activate

参考URL

https://upd.world/wordpress-cloud9/

https://qiita.com/miya0001/items/96a684e2f819f9d8b4a4

https://qiita.com/fuwamaki/items/8684003bb47197336645


PHP5.3のプロジェクトをPHP7.2にした時の流れ
2018-06-07T09:13:48+09:00
誰かが作っていたものを10年くらい前に引き継いで今も継続している案件がある。何度かサーバーは変わったが、とはいえかなり古いものなのでPHP5.3で動作していた。

ただ、お客さんの依頼で使用したいパッケージで5.3では動かないものが出てきたので、サーバー移転ついでにPHP7.2にした話。

環境


フレームワークなし
composerあり


やり方

基本的にはとりあえずPHP7.2の環境で動作させてひたすら修正していくだけ。ローカルでも一時的に借りたVPSとかでも何でも良い。自分の場合はDockerを使った。Dockerの詳細は興味ない人もいると思うので最後の方に書く。

PHP5.3というのがわりと微妙なところで、結構面倒な部分が出てくる。大きな山となったのは下記２つだった。

register_globals

古いプロジェクトなのでregister_globalsが有効化されており、しっかりとこの機能を利用して作られてしまっている。今の人は知らないかもしれないが、$_GETとか$_POSTとかで受け取る値が自動的に変数となってしまう機能。例えば$_GET['mode']とかがあったら$mode変数として使える便利機能。

http://php.net/manual/ja/security.globals.php

これはPHP5.4で削除されているので当然プロジェクト全体でエラーになる。（特にガッツリ時間をもらっているプロジェクトでもないので、新規機能追加とかは行っているがこの辺のリファクタリングは行われていない）

対処方法

extract($_POST, EXTR_SKIP);
extract($_GET, EXTR_SKIP);


解決方法としては一番ひどい方法だと思うが、動かなくなるよりはまし。というか元々ひどすぎるのでそれほど変わらない。そもそも今後フレームワーク化してこういった処理は全部消したいので、とりあえず段階的な対応。

MySQL接続

mysql_connectと関連関数が使われていた。これはPHP7では削除されるので、PDOに置き換える必要がある。

しかし、前述したとおりフレームワークが使われていないのでmysql_queryをラップした関数が色々と作成されており、ほとんどのページでその関数群が使われている。基本的にはPHP7にするとほとんどのページが動かなくなる。徐々にEloquentに置き換えてはいたが、そんなに少ない量でもないため全部をすぐ置き換えるのには無理がある。

そのため、消えたmysql_*関数を全部用意することにした。

define('MYSQL_ASSOC', 'assoc');
$conn = new PDO("mysql:host={$host};dbname={$dbname};charset=utf8", $user, $pass);

function mysql_query($query)
{
    global $conn;

    return $conn->query($query);
}

function mysql_fetch_assoc($statement)
{
    return $statement->fetch(PDO::FETCH_ASSOC);
}

function mysql_fetch_array($statement, $mode)
{
    return mysql_fetch_assoc($statement);
}

function mysql_numrows($statement)
{
    return $statement->rowCount();
}

function mysql_insert_id()
{
    global $conn;

    return $conn->lastInsertId();
}

function mysql_free_result($statement)
{
    $statement->closeCursor();
}

function mysql_error()
{
    global $conn;

    $info = $conn->errorInfo();
    if (isset($info[1])) {
        return $info[2];
    }
    return null;
}

function mysql_errno()
{
    global $conn;

    $info = $conn->errorInfo();
    if (isset($info[1])) {
        return $info[1];
    }
    return null;
}

function mysql_close($link = null)
{

}


解決方法としては一番ひどい方法だと思うが、動かなくなるよりはまし。というか元々ひどすぎるのでそれほど変わらない。そもそも今後フレームワーク化してこういった処理は全部消したいので、とりあえず段階的な対応。

ちなみに今回は使っていないので詳しくは知らないが

dshafik/php7-mysql-shim: A shim for ext/mysql in PHP 7+

というのもあるらしい。

PEAR

PEARは古いプログラムもあるので、下記の様な処理があると全部エラーになる。

$var =& Foo::factory();


上記の&がエラーになるので削除していく。

まとめ

基本的な対応は上記だが、あとはバージョンの違いでちょっとしたエラーとかも出るので見つけ次第修正していく。本当はテストである程度網羅されている事が望ましいが、古いスクラッチプロジェクトなので当然テストもない。（最近はちょこちょこCI含め追加しているが全く足りない）

一通り確認したので先日PHP7.2が走っているサーバーに移転を完了した。

ただし、プロジェクトがひどすぎる関係でこれは完成でなくあくまでも分岐点なので、最終的にはLaravelを入れて全部そちらに移行などしたい。既に一部の完全に分離できるバッチ処理等はこのプロジェクトに組み込まずGoで書いていたりする。

マイクロサービス化は色々とメリットデメリットがあげられているが、こういった古すぎるプロジェクトに関しては可能なところを分離していくと要らない部分を捨てやすくて良い。（もちろんやり過ぎはよくないと思う）

おまけでDocker

FROM php:7.2-apache

RUN apt-get update && apt-get install -y git zlib1g-dev
RUN curl -sS https://getcomposer.org/installer | php
RUN mv composer.phar /usr/local/bin/composer
RUN a2enmod rewrite
RUN docker-php-ext-install pdo_mysql mbstring zip


```yml:docker-compose.yml

version: '2'

volumes:

  mysql_data:

    driver: 'local'

services:

  mysql:

    image: mysql:5.7.19

    volumes:

      - mysql_data:/var/lib/mysql

      - ./mysql:/etc/mysql/conf.d

    environment:

      - MYSQL_ALLOW_EMPTY_PASSWORD=true

phpmyadmin:

    image: phpmyadmin/phpmyadmin

    environment:

      - PMA_ARBITRARY=1

      - PMA_HOST=mysql

      - PMA_USER=root

      - PMA_PASSWORD=

    ports:

      - 8201:80

app:

    image: myapp/php:7.2

    depends_on:

      - mysql

    working_dir: /var/www/html

    volumes:

      - .:/var/www/html

      - ./php/php.ini:/usr/local/etc/php/conf.d/myphp.ini

    ports:

      - "8200:80"

    tty: true

    stdin_open: true


```ini:php.ini
log_errors = On
error_log = /dev/stderr
date.timezone = "Asia/Tokyo"


conf:config.cnf
[mysqld]
sql_mode=''