CakePHP 2.3　ログイン、操作履歴、アクセスログ出力

2014/04/08 2017/03/11

CakePHP 2.3系でログイン履歴、操作履歴、アクセスログなどのログ出力方法

ログ出力を作ることになった経緯

　
今回は、ログイン履歴、操作履歴、アクセスログといったログの出力に関しての説明です。
　
操作ログの出力に関しては、簡単に出力できるだろうと考えていたのですが、実は意外に実装が難しかったですね。（実はそれほど難しいものじゃないのですが、CakePHPの仕様を分かっていなくてさんざん悩んでしまった、というだけですが．．．）
　
最初はもしかすると、操作ログのプラグインがあるんじゃないか、とさえ思ったのですが、そこまで甘くはなかったわけです。
単純なすべてのアクセスのログを取るものや、SQLのログを取るものはありましたが、当然ながらオリジナルで作成している Webシステムに合わせて柔軟なログを出力したい、なんていう要望が叶えられるようなものはなかったワケです。
　
　

ログ出力をファイルに出力する方法

　
今回は、まず下記のサイトを参考に Vendor内に Classを作り、処理を構築しました。
http://neoinspire.net/archives/34#.UfXaItaChph
　
ちなみに、Vendorに設置した classの呼び出し方法は、CakePHP2.Xでは変更になっていますので、下記のサイトを参考にしました。
http://www.monoreview.com/?p=35
　
————–（/app/Vendor/accesslogs.php）

<?php
class AccessLogs{
  function write_log() {
    $msg = date('Y-m-d H:i:s') . "," . env('REQUEST_URI') . "," . env('HTTP_REFERER') . "," . env('HTTP_USER_AGENT') . "," . env('REMOTE_ADDR') . "\n";

    $filename = LOGS . 'accesslogs/' . date('Ymd') . '.log';
    $log = new File($filename);
    $log->append($msg);

    return true;
  }
}
?>

<?php

class AccessLogs{

function write_log() {

$msg = date('Y-m-d H:i:s') . "," . env('REQUEST_URI') . "," . env('HTTP_REFERER') . "," . env('HTTP_USER_AGENT') . "," . env('REMOTE_ADDR') . "\n";

$filename = LOGS . 'accesslogs/' . date('Ymd') . '.log';

$log = new File($filename);

$log->append($msg);

return true;

}

————–
　
————–（/app/AppController.php）

<?php
App::import('Vendor', 'accesslogs');

class AppController extends Controller {
  public function beforeFilter() {
    $this->access = new AccessLogs();
    $this->access->write_log();
  }
}

<?php

App::import('Vendor', 'accesslogs');

class AppController extends Controller {

public function beforeFilter() {

$this->access = new AccessLogs();

$this->access->write_log();

}

————–
　
続けて、「cake/app/tmp/logs/」の中に「accesslogs」というフォルダを作ってください。
Linux系のサーバであれば、書き込み権限を設定してください。
　
これで、上記に作成したフォルダの中にログが出力されるようになります。
　
非常に簡単にアクセスログを出力する処理が作れましたので、これは今後の勉強になったかと思っています。
ですが、これをいざ実際に必要としているログイン履歴や、各ページでの操作ログを DBに保存させる処理に拡張しよう、としたら途端に分からなくなったのです。
　
　

PHPフレームワーク CakePHP 3入門

ログ出力データベースに保存する方法

　
そんなわけで、寄り道も含めて、全く違う方法で DBにログを保存する方法を探したところ、参考になりそうな下記のサイトが見つかりました。
http://pc.casey.jp/archives/750
　
こちらを参考にしながら、テーブル名は、Historyに変更し、認証処理など不要な項目を削除しました。
　
————–（テーブル）

CREATE TABLE IF NOT EXISTS `histories` (
  `id`       int(10)   unsigned NOT NULL AUTO_INCREMENT,
  `created`  timestamp          NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `system`   varchar(64)        NOT NULL,
  `level`    varchar(6)         NOT NULL,
  `client`   varchar(15)        NOT NULL,
  `message`  varchar(512)       NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

CREATE TABLE IF NOT EXISTS `histories` (

`id` int(10) unsigned NOT NULL AUTO_INCREMENT,

`created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,

`system` varchar(64) NOT NULL,

`level` varchar(6) NOT NULL,

`client` varchar(15) NOT NULL,

`message` varchar(512) NOT NULL,

PRIMARY KEY (`id`)

) ENGINE=MyISAM DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

————–
　
————–（/app/HistoriesController.php）

<?php
class HistoriesController extends AppController {
  var $name = 'Histories';

  function beforeFilter(){
    parent::beforeFilter();
  }

  function admin_index() {
    $this->write_log(__METHOD__, 'info', 'Display list view.');
    $this->set('histories', $this->paginate('History'));
  }
}
?>

<?php

class HistoriesController extends AppController {

var $name = 'Histories';

function beforeFilter(){

parent::beforeFilter();

}

function admin_index() {

$this->write_log(__METHOD__, 'info', 'Display list view.');

$this->set('histories', $this->paginate('History'));

}

————–
　
「class AppController extends Controller」の中に「write_log」の関数を編集します。
　
————–（/app/AppController.php）

class AppController extends Controller {
  function write_log($systemName, $level, $message){
    $ip = 2;
    $data = array(
      'system' => $systemName,
      'level'  => $level,
      'message' => $message,
      'client' => $ip,
      'created' => '',
    );
    $this->History->create();
    $this->History->save($data);
  }
}

class AppController extends Controller {

function write_log($systemName, $level, $message){

$ip = 2;

$data = array(

'system' => $systemName,

'level' => $level,

'message' => $message,

'client' => $ip,

'created' => '',

);

$this->History->create();

$this->History->save($data);

}

————–
　
————–（/View/Histories/admin_index.ctp）

<?php
?>
<h1>システム稼動ログ一覧</h1>
<table>
 <tr>
  <th>日時</th>
  <th>システム</th>
  <th>レベル</th>
  <th>クライアント</th>
  <th>内容</th>
 </tr>
 <!-- $remotes配列をループして、投稿記事の情報を表示 -->
 <?php foreach ($histories as $history): ?>
 <tr>
  <td><?php echo $history['History']['created']; ?></td>
  <td><?php echo $history['History']['system'];?></td>
  <td><?php echo $history['History']['level'];?></td>
  <td><?php echo $history['History']['client'];?></td>
  <td><?php echo $history['History']['message'];?></td>
 </tr>
 <?php endforeach; ?>
</table>

<?php

<h1>システム稼動ログ一覧</h1>

<table>

<tr>

<th>クライアント</th>

</tr>

<?php foreach ($histories as $history): ?>

<tr>

</tr>

<?php endforeach; ?>

</table>

————–
　
上記までの設定をすることで、ログ出力ができると思います。
一覧ページでリロードするたびにログのレコードが増えていくことが分かるでしょう。
　
　
これはこれで問題ないのですが、操作ログとして処理を作成する場合は、History以外のページでもログを出力する必要が出てきますので、その対応を作ってみました。
例えば、ログイン時にログインのログを出力する場合は、Usersでログを出力させる必要があると思いますので、まず「/Model/User.php」に Historyとの belongsToの設定を行います。
　
————–（/Model/User.php）

    ：
    ：
  public $belongsTo = array (
    'History' => array(
      'className' => 'History',
      'foreignKey' => 'id',
      'conditions' => '',
      'fields' => '',
      'order' => ''
    ),
  );
    ：
    ：

：

public $belongsTo = array (

'History' => array(

'className' => 'History',

'foreignKey' => 'id',

'conditions' => '',

'fields' => '',

'order' => ''

);

：

————–
　
続いて、「/app/HistoriesController.php」には、どのコントローラーからのアクセスなのかの情報を引数として設定します。
　
————–（/app/HistoriesController.php）

<?php
class HistoriesController extends AppController {
  var $name = 'Histories';

  function beforeFilter(){
    parent::beforeFilter();
  }

  function admin_index() {
    $ctr_name = $this->name;
    $this->write_log(__METHOD__, 'info', 'Display list view.', $ctr_name);
    $this->set('histories', $this->paginate('History'));
  }
}
?>

<?php

class HistoriesController extends AppController {

var $name = 'Histories';

function beforeFilter(){

parent::beforeFilter();

}

function admin_index() {

$ctr_name = $this->name;

$this->write_log(__METHOD__, 'info', 'Display list view.', $ctr_name);

$this->set('histories', $this->paginate('History'));

}

————–
　
さらに、「/app/AppController.php」でデータを保存する処理では、Userテーブルとの連携の設定を行います。（「HistoriesController.php」から送られてくるコントローラー名をもとに、テーブルの連携処理を振り分けます。）
これで、History以外のページからも Historyテーブルへログ保存の処理が行えるようになります。
　
————–（/app/AppController.php）

class AppController extends Controller {
  function write_log($systemName, $level, $message, $ctr_name){
    $ip = 2;
    $data = array(
      'system' => $systemName,
      'level'  => $level,
      'message' => $message,
      'client' => $ip,
      'created' => '',
    );
    if ( $ctr_name == 'Histories' ) {
      $this->History->create();
      $this->History->save($data);
    } else {
      $this->User-> History->create();
      $this->User-> History->save($data);
    }
  }
}

class AppController extends Controller {

function write_log($systemName, $level, $message, $ctr_name){

$ip = 2;

$data = array(

'system' => $systemName,

'level' => $level,

'message' => $message,

'client' => $ip,

'created' => '',

);

if ( $ctr_name == 'Histories' ) {

$this->History->create();

$this->History->save($data);

} else {

$this->User-> History->create();

$this->User-> History->save($data);

}

————–
　
この処理は、ログを出力するコントローラの数が増えれば増えるほど分岐が増えますので、もう少しいい書き方を検討する必要があるとは思いますが。
　
　
また、ログインの処理については、よくあるログイン処理をそのまま記述していると、「autoRedirect」が有効になっているため、ログイン認証が有効になったとたんに「loginRedirect」で設定してあるページに遷移してしまいます。
そのため、リダイレクトをさせる前にログ出力の処理を入れるためには、「autoRedirect」を無効にする必要がありますが、その設定に関しては、下記のサイトに分かりやすく説明がありました。
http://hima-j.in/cakephp/cakephp-last-login/
　
　

参考になるサイト

　
最後に、この記事を書くに当たって参考にしたサイトと自分でも書いてみた記事を紹介しておきます。
　
DBに値を保存する「save」メソッドに関しては下記の 2サイトが分かりやすく説明してありましたので、とても勉強になりました。
http://www.garacter.com/notes/cakephp/model/save
http://www.kaasan.info/archives/2543
　
また、下記の記事も書いていますのでご覧ください。
　CakePHP 2.3 主キー（ID）以外のキーで更新方法 updateAll
　CakePHP 2.3で saveの便利な使い方・サンプルソース付き

- CakePHP 3.x 4.x 5.x

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

Message コメントをキャンセル

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

: CakePHP3のfriendsofcake/searchでツリーカテゴリーの子階層も含めて検索する方法

CakePHP3のツリービヘイビアを使ったツリーカテゴリーの子階層も含めての検索を検索プラグイン「friendsofcake/search」を使って実現する方法を解説しました。

: CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介

PHPでサーバ情報、環境情報を取得する際は「$_SERVER」を利用するが、似たような情報をCakePHPの関数で取得する際は「getUri()」を使用する。取得出来る値は一致するものもあるが、違うものもあり便利な使い方もある。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP4から外部のデータベースにアクセスする方法解説

CakePHP4のシステムから他のシステムのデータベースにアクセスをし、SQL文を実行する方法を解説。try-catchでエラーを取得する方法も解説。

: CakePHP 2.3で saveの便利な使い方・サンプルソース付き

CakePHPのレコードを保存、更新する際に使う Saveを詳細解説します。

: CakePHP3のアソシエーションでJOINのタイプのLEFT、INNERを切り替えながら使う方法

CakePHP3でテーブルのアソシエーションしたデータの取得をコントローラー側でINNERかLEFTを指定する方法を解説。TableファイルにINNERで指定していてもController側で変更ができる。

: CakePHP 2.3　Search Pluginで検索処理　その５入力項目に複数項目入力した場合の AND検索、OR検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で複数項目を入力した場合の AND検索、OR検索についての解説です。

: CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも

CakePHPでAuto Incrementの設定を変更したときに「Duplicate entry ‘0’ for key」のエラーが出た。原因はModel内で IDを編集する処理の追加を忘れていたからだった。

: CakePHP3の検索プラグイン「friendsofcake/search」の様々な検索の仕方の実装方法

CakePHP3で検索をするプラグイン「friendsofcake/search」の検索条件のカスタマイズ方法の解説。検索項目を増やしたり、以上、以下での検索や、チェックボックスによる検索の方法などを解説。