PHP のフレームワーク、CodeIgniter でライブラリを自作し、読み込んだ時のインスタンス名ではまったので、その注意点をメモ。

CodeIgniter 本家と日本ユーザサイト

基本的なライブラリの利用方法

ライブラリの基本的な利用方法は、作って使う、の2ステップです。
たとえば次のようにします(ヘルプから)。

1. 「application/libraries フォルダ」に「Someclass」を作成
   [code lang=’php’] < ?php if (!defined('BASEPATH')) exit('No direct script access allowed'); class Someclass { function some_function() { } } ?>
   [/code]
2. コントローラから利用するコード
   [code lang=’php’] //ライブラリをロードして
   $this->load->library(‘someclass’);
   //利用する
   $this->someclass->some_function();
   [/code]

ここまでは問題ありませんでした。

はまったのは。。

私がはまったのは、ここでライブラリのファイル名およびクラス名を、「SomeClass」としたのが原因でした。

「SomeClass」のインスタンス名は「someClass」だと思って、ずっと「$this->someClass->some_function();」の様にアクセスしていたんです。

しかし、CodeIgniter は途中の文字列に関係なく、オブジェクトインスタンス名はすべて小文字で扱う必要があるのでした。

※しかし、$this->load->library(); ではファイル名の大文字・小文字は関係ないので、これも混乱の理由でした

別名も付けられる

そうなると、せっかくクラス名を CamelCase で書いたとしても、利用時にはすべて小文字でアクセスすることになり、可読性の面が気になります。

何かしら方法は無いのかと探してみたら、1.7 系からは、オブジェクトインスタンス名を変更できるようです。

そのコードは次の通り、第3引数に別名を指定するだけです。

簡単でいいですね。