ヘルプ

PHPをよく知らない、PHPのスクリプトを初めて使う

dream.phpを使えるサーバー

注意1 Nginxキャッシュ（サーバーキャッシュ）とは相性が悪いです（Cookieを利用した他の類似名前変換スクリプト全般も同様です）。お使いのサーバーで「キャッシュ」「Cache」「アクセラレータ」「高速化」「FastCGI」といった名称で当該機能がある場合は、その機能を無効化するか、もしくはキャッシュ範囲をCSSや画像などの静的ファイルのみに設定を変更するようにしてください。

注意2 上記に挙げたサーバーを含め一般的な国内運営サーバーであればほぼ気にする必要はありませんが、日本語（マルチバイト文字）での利用を想定していないような海外運営のサーバーやご自身でサーバーにPHPをインストールした場合などで、mbstring拡張モジュールがインストールされていなかったり無効化状態になっていると、一部の機能が使えなかったり、文字化けや不具合が発生する可能性があります。自力でモジュールをインストールしたり有効状態に切り替え可能なら使えます。

エディタについて

ZIPファイルの保存場所

ZIPファイルの解凍（展開）方法

各デバイスの標準機能を使うか、解凍圧縮ソフト・アプリを常用している場合はそれの使い方に沿ってください。解凍（展開）後、元のZIPファイルは削除して構いません。

ページが真っ白になる
PHPエラーが出る
名前や登録フォームが表示されない

• サーバーのPHPのバージョンに問題がある

  お使いのサーバーのPHPのバージョンがdream.phpの推奨バージョンに当てはまっているか確認してください。古すぎるバージョンや、逆にリリース直後の最新バージョンだと不具合の可能性があります。

• dream.phpのバージョンに問題がある

  dream.phpや追加アドオンスクリプトが最新か確認してください。古いバージョンには未修整のバグがあったり、お使いのサーバーのPHPバージョンに対応していない場合があります。逆にバージョンアップ作業直後に問題が発生した場合はいったんバージョンを戻して、問題点をご連絡ください。

• dream.php / use-dreamphp.jsの読み込みに問題がある

  ファイルアドレスや読み込みコードを確認してください。

  • 指定の階層にdream.php / use-dreamphp.jsがアップロードされていない
  • プラグインが有効になっていない（WordPressやFreoの場合）
  • 読み込みコードの記述位置が間違っている（詳細は各ドキュメントを参照してください）

• 書いたコードに問題がある

  名前や登録フォームを表示するコードに、全角半角大文字小文字違い、スペルミス、引用符忘れ等の記述ミスがないか確認してください。

• 拡張子やファイル名に問題がある

  作成・編集したファイルのファイル名や拡張子に問題がないか確認してください。.php で保存しないといけないファイルが.htmlだったり、設定ファイルのdream_fix.ini が dream_fix.ini.txt のように拡張子に問題があったり、 DREAM_FIX.INIのように大文字になっていたり、全角のファイル名だったり。

• 設定ファイルの内容に問題がある

  dream.phpのdream_fix.iniや、Viewerのconfigファイルなどの設定ファイルを手作業で作成・編集した場合は、タイプミスミス、無用な"や;が書かれている、逆に必要なそれらが書かれていないなど、記述に問題がないかを確認してください。

xhtml（XML）で書かれたファイルでエラーが出る

• PHPファイル内だと、XHTMLの冒頭の宣言がPHPコードとして誤認識されてしまうとエラーになります。php.iniや.htaccessを使ってshort_open_tagをOffに設定する（PHPの開始を全て<?phpにする必要があります）、もしくは以下のように宣言部分をechoすることで回避できます

  <?php echo '<?xml version="1.0"?>'; ?>

  • php xml宣言 エラー - Google検索
• HTMLとXHTMLで一部コーディングが違うので、dream.phpが出力するコードがHTML用だとヴァリデーションエラー/パースエラーになる場合があります。設定ファイルにて「xhtml出力」を設定してあるか確認してください

  ;html出力かxhtml出力か
  ;0:HTML, 1:XHTML
  form_output = 1

変換名部分が「ERROR」と表示される

変換名を表示させるコードに記述した項目番号が不正です。

• 記述した項目番号が設定ファイルで設定されている番号か確認してくだい（項目番号は「0」スタートです）
• 記述した項目番号が半角か、項目番号の前後に余分なスペースや改行が含まれていないか確認してください
• WYSIWYGエディタをお使いの場合は、項目番号部分に不要な装飾（HTMLタグ）が追加されていないか確認してください。FreoならエディタのHTMLのソースを編集、WordPressならHTMLとして編集（クラシックエディタであればテキストエディタ）などでHTMLコードを見てください

変換フォームや名前の表示は問題ないが、登録できない
登録を削除したり変更できない
登録した内容が消えている

• 読み込みコードの記述位置

  PHPの手書きで導入している場合、http://でのアクセスだと、登録フォームを表示しているページのdream.phpを読み込むPHPコードより前になんらかの記述があるとCookieが保存できません。文字、スペース、改行、BOMなどを完全に除いてファイルの冒頭にdream.phpの読み込みコードを記述してください。

  もしくは、常時SSL化して、リダイレクトで常にhttps://アクセスになるようにしてください。

• Cookieの有効階層の影響

  一度設置・登録した後に、dream_fix.iniの「サイトのURL」設定を書き換えたり、その設定と一致しないアドレスに変更すると、登録済みのCookieを上書き・削除できなくなる場合があります。一度ブラウザの設定でCookieを削除したあと、改めて動作確認してください。

• キャッシュの影響

  サーバーやプラグイン、その他お使いのスクリプトのキャッシュ処理機能の影響かもしれません。「高速化」「キャッシュ処理」「Cache」「アクセラレータ」といったような名称の機能が有効になってないか確認してください。それを無効化するか、もし詳細に設定できるのであれば画像などの静的ファイルのみをキャッシュするようにしてみてください。

• ブラウザの閲覧モード

  シークレット や プライベート のタブやウインドウでアクセスしてないか確認してください。通常のタブやウィンドウで保存したCookieはそれらの閲覧モードのタブやウィンドウでは共有されませんので未登録状態になります。また、シークレット/プライベートのタブ・ウィンドウで保存したCookieは、それを閉じると消去されます。

• ブラウザの設定

  「cookieに対応していない環境では名前を保存できません」という旨が記載されたページに飛んだり、「Cookieが有効な必要があります」のアラートが出る場合は、お使いのブラウザのCookieが有効になっていません。ブラウザの設定を変更してCookieを許可してください。

• Cookieの仕様

  Cookieは保存量（文字数や個数）に上限があります。ブラウザやその設定によって上限量や、その上限量を超えた場合の挙動は異なりますが、上限を超えるとうまく保存できなくなったり古い物から削除される可能性があります。同一ドメイン内で保存されているCookie見直して不要なCookieを削除したり、予防としてdream.phpでの登録項目数を減らしてみるなどを試してください。

  dream.phpのCookieの保存期間は365日に設定されています。それを過ぎると消えます。再登録してください。

登録してない名前が登録されている

• 過去の登録

  一度登録したCookieは、dream.phpを削除したり、dream.phpの設置階層を移動させても消えません。以前に登録したCookieが残っていた可能性があります。

• 同ドメイン内の別ページでの登録

  「サイトのURL」を設定しなかったときは、同じドメイン内全ての階層で登録Cookieが有効になります。そのページの登録フォームでは登録してなくても、別のページの登録フォームからの登録があれば、dream.phpを複数設置したとしてもCookieは共有されます。
  「サイトURL」の設定をすることでサブディレクトリ間での共有は回避することができます。ただし一度保存したCookieは当該の設定を変えてたあとも有効範囲が書き換わりませんので、ブラウザからCookieを削除して再登録してください。

• サーバーキャッシュの影響

  サーバーやプラグインのキャッシュ処理機能の影響かもしれません。「高速化」「キャッシュ」「Cache」「アクセラレータ」といったような名称の機能が有効になってないか確認しください。それを無効化するか、もし詳細設定できるのであれば画像などの静的ファイルのみをキャッシュするようにしてみてください。

カスタム表示できない・カスタム表示以降が表示されない・カスタム表示が文字化けする

• お使いのサーバーにmbstringモジュールがインストール・有効化されているか確認してください
• 表示のためのコードが全角半角大文字小文字、必要な引用符含めて正しいか確認してください
• dream.phpと同じ階層にdream_expand.phpが存在しているか（アップロードしてあるか）確認してください
• サイトで利用している文字コードとdream.php/dream_expand.phpおよび設定ファイルの文字コードが全て同じか確認してください
• 1文字だけの登録を途切ったり区切ったりする、漢字の母音を取得したりひらがなカタカナ変換したりするなど、登録情報によってはカスタム無効になる場合があります。カスタムできる情報を登録してください
• dream.phpのバージョンによっては使えないカスタムタイプがあります。最新のdream.phpを再度DLしてください

登録フォームのデザインが適応されない

• 登録フォームのためのCSSが読み込まれているか確認してください
  • CSSファイルをアップロードし忘れている
  • 読み込むスタイルシートのアドレスを間違えている
  • CSSの読み込みコードが書いていない・コードを書き間違えている
• キャッシュや一時的な通信不調でCSSがうまく読み込めていないかもしれません。スーパーリロードするか、ブラウザのキャッシュを削除してみてください
• 古いブラウザや特定のブラウザは一部のCSSに対応していない場合があります。どうしても見た目を揃えたい場合は、より多くの環境で対応されている別のやり方を使う、各ブラウザの拡張機能を利用して補うなどで対応するか、文字が重なるなど閲覧や動作に問題が発生するのでなければそういうものと思って諦めてください

フォームで登録するとページ上部に戻ってしまう

フォームが送信されることでページが再読み込みされるため、スクロールした先にある名前登録フォームを使うと上部に戻るような挙動になります。

Cookieはページの読み込み時に取得できるので、フォームでクッキーを保存し、かつすぐにクッキーを読み込んで変換を有効にする機能上の仕様です。

どうしても気になるようなら、スクロールしない最上部に近い位置に登録フォームを表示する、登録フォームの自動出力ページや自作した登録フォームを表示させたページへリンクする or iframeなどでそのページを表示させるなどで対応してください。ただしiframe外やリンク先からのブラウザバック直後はクッキーが有効になりません。リロード後、もしくはリンク先から有効になりますのでご注意ください。

※dreamphp6で改良予定

.htaccessが同梱されていない、アップロードできない、エラーが出る

環境によっては.htaccessファイルは非表示だったり扱えなかったり、サーバーによって対応していなかったりエラーが出たりする場合があります。

同梱の.htaccessの内容は、設定ファイルなどに対する直接アクセス禁止のみで、プログラムの動作自体には影響はありませんので、.htaccessのファイルを取り扱えない環境であれば無しなら無しでも支障ありません。

同サーバー内で複数のdream.phpを設置したい

設定内容が同じ、或いは新しいdream.phpを設置したい理由が登録項目を「増やす」ことで対処できる範囲なのであれば、複数設置する必要はありません。dream.phpを適切に読み込めさえすれば、dream.php や dream.phpを読み込むファイルがどこに階層にあっても基本的に問題ありません。

複数設置することで、どのページでどのdream.phpを使っているかの判断が難しくなって解決が遅れたり、バージョンアップ時やなにか起きた時に手数がかかることになります。

逆に、なんらかの事情で、設定内容が違うdream.phpを複数設置しようとするとCookieが干渉しあってしまいます。下記を参照してください。

同じサイト内で使う

dream.phpは、登録項目を自由に増減したり、デフォルト名をページごとに差し換えたり、特定の項目の登録フォームだけ表示させることができます。
「長編A用のデフォルト名【A】と長編B用のデフォルト名【B】」のようなデフォルト名の使い分けであれば、出力単位・ページ単位等でのデフォルト名は変更できます。
「女夢主作品用の【苗字】【名前】と男夢主作品用の【苗字】【名前】」というような利用場所の使い分けをしたければ、「女夢主用苗字・女夢主用名前・男夢主用の苗字・男夢主用の名前」の4つを登録項目として設定してください。

異なる階層のサイトで使う

domain.com/aaa と domain.com/bbb で別々のサイトを運営して、それぞれでdream.php使いたいような場合は、dream_fix.iniでURLを設定してください。

;ドメイン直下以外で運営している場合はサイトのURLをhttpから
site_url = "http://domain.com/aaa/"

異なるサブドメインのサイトで使う

同じサーバー内でも、aaa.domain.com と bbb.domain.com や ccc.xxx.jpで使う場合は、そのまま複数設置して問題ありません。

ローカルで動作（確認）したい

PHPファイルは基本的にサーバーにアップロードしないと実際の実行状態を確認できません。ローカルに設置（動作確認含む）したい場合は、そのための環境構築が必要です。

以下のようなソフトウェアを利用すれば、基本的にそれをインストールするだけで完了します。先人たちによる日本語で書かれた詳しい導入手順や使い方、各ソフトウェアの特徴も検索すると多数出てきます。

• ampps
• MAMP
• Laragon
• Local
• XAMPP

• ローカル環境 PHP - Google検索

dream.phpを最新にバージョンアップしたい

更新内容によって、dream.php、もしくは更新された各同梱ファイルのいずれかを上書きしてください。更新ファイルについて詳しくは更新履歴をご確認ください。

（気をつけてはいますが）開発者のほうがなにかミスをしていたり、新たなバグが発生している可能性があります。なにかありましたら、最新バージョンに不具合があることを連絡してくださると有難いです。事前にローカルで動作確認をしてからアップロードしたり、問題なく使っていた旧バージョンファイルを別に残しておいて問題が起こったらすぐ戻せるように措置をとっておいてください。

機能の提案や修正・改善要望・解決しない問題がある場合

• dream.phpにつけて欲しい機能がある
• dream.phpについてもっと詳しく解説して欲しい部分がある
• dream.phpや解説ページについて、明らかなバグやミスを見つけた
• dream.phpや解説ページについて、こうしてほしい・こうしてほしくないという要望がある
• ヘルプを見たが解決しない問題が発生した

提案や要望、質問がある方や、なにか不具合が起こってヘルプが欲しい方は、メール や X（Twitter）で連絡してください

希望や要望は今後のdream.phpの開発の参考にします。全ての要望を必ず叶えることは難しいかもしれませんがご容赦ください。