CakePHP 2.x系　Viewでのコメントの記述方法など

PHPと CakePHPの相違点

　
CakePHPの初心者である私が、CakePHPを始めてすぐのころに、フレームワークなしの PHPとの相違点などでハマった点などを書いてみたいと思います。
　
　
まず、CakePHPのコーディング規約は下記の URLにあります。
http://book.cakephp.org/2.0/ja/contributing/cakephp-coding-conventions.html
　
これは、規約と書かれていますので、基本的にこの規約に従って記述するものなのですが、この通りに書かないと動かないところと、この通りに書かなくても動くところとあります。
それがまた厄介な問題を引き起こすわけですが．．．
　
　

PHPタグの記述の仕方の相違点

　
まず、PHPタグ。
　

PHPタグ

　
上記のコーディング規約にも「常にショートタグ（＜? ?＞）の代わりに、ロングタグ（＜?php ?＞）を使ってください。」と書いてあります。
この規約は、この通りに書かないと動かない部分で、初めて CakePHPを使った際にはこれに気づかず、この問題だけで半日くらいつぶしてしまいました．．．．
　
　

Viewファイルでのコメントの記述方法

Viewファイルの中でのコメントの表記

　
コメントについて
「.php」のファイルは、「#」「//」「/* ～ */」が使えます。
Viewの「.ctp」ファイルでは、「/* ～ */」しか使えません。
　
CakePHPのコメントは、フレームワークを使わない PHPと同じく「#」「//」「/* ～ */」が使えます。
でも、これは、あくまでも「.php」の拡張子がつくファイルの Controlloerや Modelのファイルに限定されます。
つまりは、Viewは「.ctp」となりますので、PHPと同じコメントを利用することができないということになり、Viewで利用できるコメントは、「/* ～ */」のタイプのみになります。
　
また、「<?php」の直後にコメントの記号を書く際は、「<?php /*」のように「<?php」の後ろにはスペースを入れる必要があります。「<?php/*」のようにつなげて書くとPHPのコードとして認識されなくなります。
なお、フレームワークを使わない PHPではつなげて書いてもしっかりコメントとして認識されます。この違いによって、この正しいコメントの表記方法に気づくまでに 1ヶ月以上かかってしまいました．．．
　
正しい表記：
＜?php /* コメント文章 */?＞
　
誤った表記
＜?php/* コメント文章 */?＞
　
　
[amazonjs asin=”4798048577″ locale=”JP” title=”PHPフレームワーク CakePHP 3入門”]
　

PHPのコメントを利用して HTMLソースを表示させない方法

　
ちなみに、この Viewファイル上でもそうですし、一般的な HTMLのソース上でも、HTMLをコメントにしたいけど HTMLのコメントはソースが見えてしまうので．．．という場合は、PHPのコメント処理を使うことで HTMLを出力させない、という方法を採っていました。
HTMLファイルの場合は、PHPが処理される状況でないと使えない方法ではありますが、この方法を教えてもらったときは感動に近いオドロキがありましたね。
それ以降、かなり頻繁に使っている手法です。利用されている方も多いとは思いますが
　
具体的には
　
※HTMLのコメントタグの場合
＜!–
＜div＞テストの項目＜/div＞
–＞
　
※PHPのコメントタグの場合
＜?php /*
＜div＞テストの項目＜/div＞
*/ ?＞
　
このように記述することで HTMLがブラウザに表示されないだけではなく、そもそも出力がされなくなりますので、安心してコメントとして残しておくことができるようになります。
　
　

フレームワークを使わない PHPはなんと表現するか？

　
ところで、CakePHPと、フレームワークを使わない普通の PHPを区別して表現する場合、フレームワークを使わない普通の PHPの方は、なんと表現するのが一般的なのでしょう？
「フレームワークを使わない PHP」といったような表現をするしかないのでしょうか？？