こんにちは。フリーランス・コンサルタント＆エンジニアの九保すこひです。

X（Twitter）やってます！
九保すこひ＠フリーランスエンジニア｜累計300万PVのブログ運営中

さてさて、前回記事では久しぶりにLaravelのパッケージ「laravel-js-helper」を公開しました。

実は少し前までよくLaravelの独自パッケージをつくって公開していたのですが、最近はあまり「気乗りがしない」というか、なんとなく避けている部分がありました。

「あんなに好きだったのになぜだろう❓」

と考えていたのですが、この度その理由を突き止めることができました。
その理由とは・・・・・・

「メンテナンスがめんどう…😣」

というものです。

つまり、Laravelに新バージョンが追加になるとその都度、パッケージごとに開発環境をつくらないといけないので「うーん、仕事じゃないし、、後でね…」となってしまうのです。

そこで❗

今回は、「１つのフォルダで複数バージョン向けのパッケージ開発」をする方法を考えてみました。

ぜひ何かの参考になりましたら嬉しいです。😄✨

※ 今回はさすがに需要が少ないと思いますが、ぜひ一流ピッチャーがよくやる「緩急をつけたピッチング」だとお考えください。そのうち豪速球ストレート投げますね（笑）

「ワンインチパンチが
打てるようになりたい❗」

1 前提として
2 パッケージのためのフォルダを用意する
3 composer でローカルのパッケージがインストールできるようにする
4 パッケージ内のユニットテストが実行できるようにする
5 実際にやってみる
6 企業様へのご提案
7 おわりに

前提として

今回は実際の例として、以下４つのバージョンに向けて、１つのフォルダだけでパッケージ管理する方法をご紹介します。

Laravel 6.x
Laravel 7.x
Laravel 8.x
Laravel 9.x

また、サンプルとしてとりあげるのは前回記事で紹介した「laravel-js-helper」ですが、もちろん自由にご自身のパッケージ名に置き換えてOKです。

※ なお、この記事では「パッケージ本体のつくりかた」は書いてません。ゴメンナサイ。もし興味がある方は、その昔別ブログで書いたこちらの記事をご覧ください。今でも基本は同じだと思います。

では、やってみましょう❗

パッケージのためのフォルダを用意する

まずは、フォルダ構成です。

あるフォルダに各Laravelがインストールされていると思いますが、このフォルダと「並列の位置」に「packages」フォルダを作成します。

そして、このpackagesフォルダの中に実際のパッケージ名がついたフォルダを用意します。（今回の例は「laravel-js-helper」になります）

つまり、階層で言うと以下のようになります。

開発フォルダ
└ laravel6x
└ laravel7x
└ laravel8x
└ laravel9x
└ packages
　　└ laravel-js-helper

そして、このままでは各Laravelフォルダからpackagesフォルダを参照できないので「シンボリック・リンク」を貼り「あたかもそこに存在しているように」します。

私の環境はUbuntuなので、以下のようなコマンドで実行できます。

ln -s /（開発フォルダ）/laravel9x/packages packages

※ windowsでシンボリック・リンクを使う方法は以下をご参照ください。（クラスメソッドさんはホント有益ページしかありませんね 👍）

📝 参考ページ： Windowsでシンボリックリンクを作る

すると、Laravel9xフォルダ内に「packages フォルダが存在している」ことにしてくれます。

後は、残りの「laravel8x」「laravel7x」「laravel6x」フォルダにも同じくシンボリック・リンクを貼れば完了です。

※ ちなみに、後で紹介する「ユニットテスト」ができるよう、あえてこの位置にリンクをつくっています。

これでパッケージを一元管理できるフォルダ構成になりました❗

composer でローカルのパッケージがインストールできるようにする

Laravelのパッケージはcomposerで管理することになりますが、いちいちGitHubに上げてPackagistに反映されるのを待って、インストールして…となるといくら時間があっても足りません。

そこで❗

composer.jsonをいじって、「ローカルに置いてるパッケージ」をインストールできるようにします。

以下のコードを追加してください。

composer.json

// 省略

"repositories": [
    {
        "type": "path",
        "url": "packages/your-package-name"
    }
],

※「your-package-name」は自由に変更してください。

これで、例えば以下のようにしてローカルのパッケージをインストールすることができるようになります。

composer require "sukohi/laravel-js-helper @dev"

なお、一度ローカルからパッケージをインストールすると、その都度インストールしなくても変更がダイレクトで反映されます。便利ですね👍

パッケージ内のユニットテストが実行できるようにする

複数バージョン向けにパッケージをつくる場合、ユニットテストがあればコマンドを実行するだけでうまくいっているかチェックでき、とても便利です。

そこで、ここでは「パッケージ内にある」ユニットテストが実行できるようcomposer.jsonを変更してみましょう。

composer.json

"autoload-dev": {
    "psr-4": {
        "Tests\\": "tests/",
        "Vendor\\YourPackageName\\Tests\\": "packages/your-package-name/tests/"
    }
},

※ 「Vendor」、「YourPackageName」、そして「your-package-name」は自由に変更してください。

そして、phpunit.xmlへパッケージ内にあるテスト・フォルダを指定すれば完了です。

phpunit.xml

<!-- 省略 -->

<testsuites>
    <testsuite name="Unit">
        <directory suffix="Test.php">./tests/Unit</directory>
    </testsuite>
    <testsuite name="Feature">
        <directory suffix="Test.php">./tests/Feature</directory>
    </testsuite>
    <!-- 👇 ここを追加 -->
    <testsuite name="YourPackageNameFeature">
        <directory suffix="Test.php">./packages/your-package-name/tests/Feature</directory>
    </testsuite>
</testsuites>

<!-- 省略 -->

これでユニットテストの準備も完了です❗