phpファイルで他のファイルのphpを表示する方法

Question

こういったファイルがあってh1タグの中に他のphpファイルの中身を表示したいとき

Hello.php

略
<h1>
        <?php include("small-title.php"); ?>
</h1>
略

small-title.php

Hello,World!

このときローカル開発環境でHello.phpを実行してHello.World!を表示するにはこの書き方であっていますか？

Answer 1

別な方法をいくつか。

別ファイルには変数を格納し、それを表示するというやり方が誰しも最初に思いつく方法でしょうか。

<?php
//small-title.php
$G_TITLE = "Hello,World!";

<?php
//Hello.php
include_once('small-title.php'); ?>
<h1><?php echo $G_TITLE; ?></h1>

ただ、あまりグローバル変数が増えるのはよろしくないので、大抵の場合はクラスを用意します。不変的な値の場合は、定数として定義するのが良いかと思います。以下は定数を使用した例。

<?php
//small-title.php
class DefineTitle{
  const TITLE = "Hello,World!";
}

<?php
//Hello.php
include_once('small-title.php'); ?>
<h1><?php echo $DefineTitle::TITLE; ?></h1>

その他の方法としては、テンプレートエンジンを使う

• Smarty http://www.smarty.net/docsv2/ja/
• Twig http://twig.sensiolabs.org/

PHPと共存できなくてもよく、特定の箇所に特定の文字列を表示したいだけなら、SSIなどWebサーバの機能を使う方法もあります。

• SSI http://www.tohoho-web.com/wwwssi.htm
• Apacheのモジュールで対応 http://www.psi-net.co.jp/blog/?p=1111

Answer 2

間違ってはいません。
別な方法もございます。

Comments

[YamamotoHiroki]

一般的に見て不自然ですか？
独学なのでそういうところも少しは知っておきたいです。

[退会済みユーザー]

そうですね。
includeは、スクリプト実行時に読み込まれたphpのコードをそのままその場所に展開して評価します。

ですから、貴方の書いたように文字列を読み込むために利用することはあまりありません。

ブラウザに出力するにはエスケープ処理などが必要になってくるのですが、includeで読み込むと、読み込んだphp側でエスケープ処理をしておかなければならなくなります。

ですから、同じことをするとしたら、

<?php
$text = file_get_contents("small-title.php");
$text = htmlspecialchars($text, ENT_QUOTES, "UTF-8");
?>
<h1>
<?php echo $text; ?>
</h1>

等の様にした方がよろしいかとは思います。

[YamamotoHiroki]

なるほど、ありがとうございます！