CakePHP3でComposerでインストールできないプラグイン、外部ライブラリを vendorに入れて手動で読み込む方法

2018/08/11 2019/03/02

CakePHP3で vendorに置いたプラグインを手動で読み込み使う方法解説

CakePHP3でのプラグインは Composerを利用してインストールする方法がメイン

　
CakePHP3で外部のライブラリやプラグインを使う場合は、Composerを使ってインストールしましょう、と書いてあります。
公式サイトや解説してくれているブログなども Composerを利用する方法の解説がほとんどです。
　
私も下記の様に、Composerを使ってプラグインをインストールする方法を解説しています。
CakePHP3でcomposerを利用してライブラリ・プラグインをインストールする方法
　
　
ですが、自作のライブラリであったり、Composerからインストールするファイルが用意されていないプラグインもありまして、そのようなプラグインをどうやって利用するか、詳しく解説しているサイトが見当たらない状況でした。
　
　
そんなある日、とあるサービスの APIを利用して、とある Webサービスを開発することになりましたが、その APIから提供されているサンプルプログラムには Composerを利用してインストールする仕組みが用意されていなかったのです。
　
そんなわけで、サンプルソースをダウンロードしてきたものの、それをどう使えばいいのかがよく分からない！という状況になってしまったのです。
　
そんなわけで、Composerを利用せずに外部ライブラリ、プラグインをインストール、読み込む方法、それを利用する方法を調べましたので、解説します。
　
　
ちなみに、この記事で解説する方法は、Composerは使用しますので、Composerは必要です。
Composerすら使わない方法はまたいずれ。
　

「/vendor/」にプラグインのファイル一式を設置

　
「/vendor/testabc/src/」にプラグインのファイル一式を設置します。
　
下記のサンプルは、「/vendor/testabc/src/」に設置したファイル一式のうちの一つ、「/vendor/testabc/src/GetTestData.php」ファイルです。
　

<?php
namespace TestAbc;
use SoapUtils;
class GetTestData {
    public function getData($id) {
        require_once(dirname(__FILE__).'/SoapUtils.class.php');

       （プラグインの処理）

    }
}

<?php

namespace TestAbc;

use SoapUtils;

class GetTestData {

public function getData($id) {

require_once(dirname(__FILE__).'/SoapUtils.class.php');

（プラグインの処理）

}

　
コントローラーやシェルから呼び出されるファイルの最初には「namespace」を記述します。
ここに記述する「namespace」の名前「TestAbc」は、次の項で説明する「/composer.json」に付けるプラグインの名称、もしくは、プラグインの名称からのパスを記述します。
　
　
また、6行目で「require_once()」でファイルを読み込んでいますが、プラグイン内から読み込むファイル「SoapUtils.class.php」には、「namespace」の追加などの対応は必要ありません。
　
　

「namespace」の付け方

　
「namespace」の付け方は先に少し説明しましたが、「/composer.json」に付けるプラグインの名称、もしくは、プラグインの名称からのパスを記述します。
　
例えば、
「/vendor/testabc/src/GetTestData.php」
にファイルを設置したとします。
　
そして、「composer.json」には、
「"TestAbc\\": "vendor/testabc/src/"」
と記述したとします。
　
この場合の「namespace」は
「namespace TestAbc;」
となります。
　
　
また、「GetTestData.php」を置いたフォルダの中にさらにフォルダを作成し、下記のように
「/vendor/testabc/src/Abc/xyz/GetTestData2.php」
にファイルを設置したとします。
　
この場合は、「GetTestData.php」のプラグインの関連プログラムなので、「composer.json」は変更しません。
　
この場合の「namespace」は、「/vendor/testabc/src/」からのパスを付けて記述しますので
「namespace Abc\xyz\TestAbc;」
となります。
　
　

「/composer.json」ファイルにプラグインの情報を追記

　
続いて、前項で設置したプラグインの情報を「/composer.json」ファイルに記述します。
追加する内容は、下記の 5行目の情報になります。
　

    "autoload": {
        "psr-4": {
            "App\\": "src/",

            "TestAbc\\": "vendor/testabc/src/"
        }

"autoload": {

"psr-4": {

"App\\": "src/",

"TestAbc\\": "vendor/testabc/src/"

}

　
この「TestAbc」は、自由に分かりやすい名称を付与します。
この名称「TestAbc」は、前項で説明した、呼び出される側のプログラムの「namespace」として設定するほか、Controller側、Shell側で呼び出すときの「use句」で「use TestAbc」のように指定する時の名称になります。
　
「vendor/testabc/src/」は、プラグインのファイルを設置したフォルダのパスを指定します。
　
　
また、3行目の「"src/"」の行末の「,（カンマ）」の付け忘れに注意しましょう。忘れがちですので。
　

「composer.json」ファイルの設定変更を有効にするためのコマンドを実行

　
前項で設定を変更した「composer.json」ファイルの内容を有効にするために、下記のコマンドを実行します。
　

$ composer dump-autoload
Generating autoload files
> Cake\Composer\Installer\PluginInstaller::postAutoloadDump

$ composer dump-autoload

Generating autoload files

> Cake\Composer\Installer\PluginInstaller::postAutoloadDump

　
このコマンドを実行することで、下記のファイルなどの「/vendor/composer/」フォルダの中にある設定情報が更新されます。
　
　/vendor/composer/autoload_psr4.php
　/vendor/composer/autoload_static.php
　
　
Composerにパスが通っていない場合などは、上記のコマンドではエラーが発生する場合があります。
その場合は、下記のコマンドを試してみてください。
　

$ php composer.phar dump-autoload

1	$ php composer.phar dump-autoload

設定したプラグインをコントローラー、シェルから呼び出す方法

　
前項までの設定で、プラグイン、ライブラリ側の設定が終り、呼び出せる状態にすることができました。
　
あとは、コントローラーやシェルに、そのプラグイン、ライブラリを呼び出す記述をするだけです。
　
　
サンプルとしてシェル「GetDataShell.php」を作成しました。
　

<?php
namespace App\Shell;

use Cake\Console\ConsoleOptionParser;
use Cake\Console\Shell;

use TestAbc;

class GetDataShell extends Shell {

    public function main() {

        // GetTestDataクラス読み込み
        $getDataObject = new TestAbc\GetTestData;

        // データ取得の実行
        $getDataArray = $getDataObject->getData();

        （以下省略）

<?php

namespace App\Shell;

use Cake\Console\ConsoleOptionParser;

use Cake\Console\Shell;

use TestAbc;

class GetDataShell extends Shell {

public function main() {

// GetTestDataクラス読み込み

$getDataObject = new TestAbc\GetTestData;

// データ取得の実行

$getDataArray = $getDataObject->getData();

（以下省略）

　
まず、7行目で、「use句」を使ってプラグインを使用することを宣言します。
　
続いて、14行目の「new TestAbc\GetTestData」ように「プラグイン名 \ クラス名」として、インスタンスを作成します。
　
これで、ようやく 17行目の記述でアクションが実行できるようになります。
　
　
CakePHP3でシェルを作成する方法については、下記の記事で解説しています。
CakePHP3でシェルを作成しコマンドラインから実行・CakePHP2との違い
　
　
一般的には、シェルよりコントローラーとしてプログラムを開発することの方が多いと思いますが、その場合もシェルと大きな違いはありません。
サンプルとしてコントローラー「GetDataController.php」を作成するとすると、下記の様になります。
　

<?php
namespace App\Controller;

use App\Controller\AppController;

use TestAbc;

class GetDataController extends AppController {

    public function index() {

        // GetTestDataクラス読み込み
        $getDataObject = new TestAbc\GetTestData;

        // データ取得の実行
        $getDataArray = $getDataObject->getData();

        （以下省略）

<?php

namespace App\Controller;

use App\Controller\AppController;

use TestAbc;

class GetDataController extends AppController {

public function index() {

// GetTestDataクラス読み込み

$getDataObject = new TestAbc\GetTestData;

// データ取得の実行

$getDataArray = $getDataObject->getData();

（以下省略）

　
まさに「Shell」が「Controller」に変わっただけです。
　
　

CakePHP3で vendorに置いたプラグインを手動で読み込み使えるようにする方法のあとがき

　
APIなどでサンプルとして提供されているソースファイルなどを CakePHP3で使用する場合、vendorの中に設置して、そのサンプルソース、ライブラリなどを利用したい、と思う場面がありました。
　
ですが、それをどうやったら使えるのか。
　
ググっても、プラグインのインストールには Composerを使ってインストールしましょう、というサイトばかりが出てきます。
Composerでインストールできるファイルを提供していないプラグインの場合はどうすればいいのでしょうか？
　
Composerを使わずにインストールする方法が書いてあるサイトも、情報が少なすぎてそのサイトだけを見ても分からないサイトばかりでした。
　
というワケで、CakePHP3になれていない方であっても分かるように、かなり細かなところまで解説した記事を作成しました。
私と同じように悩んでいる方の助けになれば、と思います。
　
　

- CakePHP 3.x 4.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説

CakePHP3でOGPを設定する方法を解説。fetch、assignを使用しレイアウトファイルに編集した変数にテンプレートファイルから値を指定する。これを利用してOGPを編集する。

: CakePHP4でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

CakePHP4でcontrollerで実行したバリデーションの結果をModelのバリデーション結果に追加するメソッド「setError()」「setErrors()」の使い方の解説。

: CakePHP3のアソシエーション機能を使い関連レコードをまとめて削除

CakePHP3でレコードを削除する際に関連するレコードをまとめて削除する機能の解説。フレームワークのメリットを存分に発揮し、コマンドを1行追加するだけで実装可能。

: CakePHP3のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。ユーザ新規登録の流れを紹介しつつテンプレートファイルがどこにあるか、設定情報ファイルがどこにあるか、を説明しつつカスタマイズの方法を解説します。

: CakePHP3でQRコードを作成、表示するライブラリ「cakePHP-QR-Code-Helper」

CakePHPでQRコードを生成するライブラリ「cakePHP-QR-Code-Helper」の紹介。GDライブラリのインストールも必要ないHelperとして提供されているため、ファイルを設置すればすぐに使用可能。

: CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。Usersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

: CakePHP3で環境変数を設定して本番環境と開発環境を分けて処理をする場合

CakePHP3で開発環境と本番環境とで違う設定ファイルを読み込ませて環境ごとに定数を切り替える方法を解説。Apacheのhttpd.confに環境変数を設定し、それを読み込み判別する。

: CakePHP3にデイトピッカー jQuery UI DatePickerを実装する手順の解説

CakePHP3にjQuery UIのDatePickerを実装する手順を説明。併せて、デイトピッカーを設置に関連するCakePHP3の解説と、テーマを変更したり、表記を変更するカスタマイズする方法なども紹介。

: CakePHP3のCakeDC/UsersのUserHelperでログアウトやreCAPTCHAをカスタマイズ

CakeDC謹製Usersプラグインの紹介。UserHelperを利用し、ログアウトのリンクや権限があるときのみ表示されるリンク、プロフィールページへのリンク、reCAPTCHAの設置方法などを解説。

: URL短縮サービス「TTTオンライン（https://ttt.onl）」公開

URL短縮サービス「TTTオンライン（https://ttt.onl）」を公開。メールやSNSでは使いにくい長いURLを短いURLに変換するサービス。QRコードも。Google URL Shortenerが2019年3月にサービス終了。