Q&A
なるほど！とても勉強になります。
ご丁寧にありがとうございます…！
前提・実現したいこと
phpで、GoogleAPIなどの外部APIを使う用のライブラリを作ってみたいと思っています。
そこで、ライブラリなどはどのようなディレクトリ構成にするのが一般的なのでしょうか？
ライブラリの役割としては、アプリケーションからのデータをAPIに送信し、受信した値を変換してアプリケーションに返すということをしたいです。
また、APIトークンなどの設定もどこにすればいいのでしょうか？
試したこと
Carbonなどのディレクトリ構成は確認したのですが、これが良さそう！というのが思いつきませんでした。
よろしくお願いいたします。
回答3件
0
ベストアンサー
composer対応してPSR-4に準拠すればディレクトリ構成は自動的に決まる。
いくつかcomposerパッケージ見ればすぐに分かる。
規約なので良いも悪いもない。
そんなことよりも名前空間が大事。
Carbonはこうだけど
"autoload": { "psr-4": { "Carbon\": "src/Carbon/" } },
今からなら最上位にベンダー名入れた名前空間にしたほうがいい。
"autoload": { "psr-4": { "(他と被らない自分のベンダー名)\(パッケージ名)\": "src/" } },
先にGitHubとpackagistのアカウント作ってそのIDをベンダー名にする。
CarbonならnesbotがpackagistのID。こうやって使われるので重要。
composer require nesbot/carbon
ユーザー視点ではpackagistのIDと名前空間しか見ない。
use (他と被らない自分のベンダー名)(パッケージ名)\Foo;
src以下は当然PSR-4としか思ってない。
投稿2019/05/31 01:39
退会済みユーザー
総合スコア0
0
ライブラリ管理という視点ではこれから作るPHPのアプリケーションであればcomposerで外部ライブラリを管理するのがベストプラクティスと言える状態になっています。
そのため、ライブラリ開発にあたってもcomposerに寄せると良いんではないかなと思っています。
ライブラリなどはどのようなディレクトリ構成にするのが一般的なのでしょうか？
どうやって配布/使用するかにもよりますが、ライブラリ全体としては
- composerで管理するようにする
composer 自作ライブラリあたりで検索 - そこまでやらなくても、composerでautoload出来るようにする 参考
として、ディレクトリ構成はよく使われている構成に近いものにすると、ディレクトリの役割の共通認識が作りやすいです。
APIトークン等の使用する環境固有の情報はライブラリの本体には含ませず、
ライブラリを使用するアプリケーションの環境情報を管理するファイルで管理して、
アプリケーションがそのライブラリのコンストラクタに与える形にするのが良いかなと思います。
投稿2019/05/31 01:50
総合スコア18778
0
ディレクトリ構成のベストプラクティス
ないです。要件次第となります。
どういうAPIなのか、どういう機能を提供しているのか。
結局のところURLが叩かれて実行されるものとなりますので、
通常のWebサイトを作るときと考え方はあまり変わらないと思います。
強いてならAjaxでPHP実行するときのことを考えると良いのでは。
設定ファイルはURLでアクセスできる場所には置かないとか、そういった配慮は必要ですし、
フレームワークを利用するのであればフレームワークのルールに従うことになります。
投稿2019/05/31 00:21
総合スコア80888
あなたの回答
tips
プレビュー
バッドをするには、ログインかつ
こちらの条件を満たす必要があります。
2019/05/31 01:48