<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/install.windows.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'install.windows.commandline.php',
    1 => 'Windows で PHP をコマンドラインで動かす',
    2 => 'Windows で PHP をコマンドラインで動かす',
  ),
  'up' => 
  array (
    0 => 'install.windows.php',
    1 => 'Windows システムへのインストール',
  ),
  'prev' => 
  array (
    0 => 'install.windows.building.php',
    1 => 'ソースからのビルド',
  ),
  'next' => 
  array (
    0 => 'install.cloud.php',
    1 => 'クラウドコンピューティングプラットフォームへのインストール',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'install/windows/commandline.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="install.windows.commandline" class="sect1">
 <h2 class="title">Windows で PHP をコマンドラインで動かす</h2>
 <p class="para">
  この節では、PHP を Windows のコマンドラインで実行するときの注意点やヒントを説明します。 
 </p>
 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="para">
   まず最初に <a href="install.windows.manual.php" class="link">
   手動でのインストールの手順</a> を読みましょう!
  </p>
 </p></blockquote>
 <p class="para">
  特に Windows に手を加えなくても、PHP をコマンドラインから実行することはできます。
  <div class="example-contents screen">
<div class="cdata"><pre>
C:\php\php.exe -f &quot;C:\PHP Scripts\script.php&quot; -- -arg1 -arg2 -arg3
</pre></div>     
  </div>
 </p>

 <p class="para">
  しかし、次の手順に従えば、さらにシンプルに実行することができます。
  この中にはすでに実行済みのものがあるかもしれませんが、
  順を追って進めていくために
  もう一度ここで説明しておきます。

  <ul class="itemizedlist">
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     <var class="envar">PATH</var> と <var class="envar">PATHEXT</var> は
     Windows で重要な働きをするシステム変数です。
     既存の変数の値を上書きしないように注意しましょう。
     あくまでも追記するだけにします。
    </p>
   </p></blockquote>

   <li class="listitem">
    <p class="para">
     PHP の実行ファイル (<var class="filename">php.exe</var>、
     <var class="filename">php-win.exe</var> あるいは
     <var class="filename">php-cli.exe</var>。
     PHP のバージョンや設定によって変わります)
     がある場所を環境変数 <var class="envar">PATH</var> の最後に追加します。
     PHP のディレクトリを <var class="envar">PATH</var> に追加する方法は、<a href="faq.installation.php#faq.installation.addtopath" class="link">FAQ の項目</a>
     を参照ください。
    </p>
   </li>

   <li class="listitem">
    <p class="para">
     拡張子 <code class="literal">.PHP</code> を、環境変数
     <var class="varname">PATHEXT</var> の最後に追加します。これは、環境変数
     <var class="envar">PATH</var> の変更と同時に行うこともできます。
     <a href="faq.installation.php#faq.installation.addtopath" class="link">FAQ</a>
     に書かれている手順に従いましょう。ただし、環境変数
     <var class="envar">PATH</var> の部分は
     <var class="varname">PATHEXT</var> に変更します。
     <blockquote class="note"><p><strong class="note">注意</strong>: 
      <p class="para">
       <code class="literal">.PHP</code> をどの位置に書くかによって、
       ファイル名がマッチしたときに実行されるスクリプトあるいはプログラムが決まります。
       たとえば <code class="literal">.PHP</code> を
       <code class="literal">.BAT</code> より前に書くと、
       同じ名前のバッチファイルがあってもスクリプトのほうを優先して実行します。
      </p>
     </p></blockquote>
    </p>
   </li>

   <li class="listitem">
    <p class="para">
     拡張子 <code class="literal">.PHP</code> をファイル形式と関連づけます。
     これは、次のコマンドで行います:
     <div class="example-contents screen">
<div class="cdata"><pre>
assoc .php=phpfile
</pre></div>     
     </div>
    </p>
   </li>

   <li class="listitem">
    <p class="para">
     ファイル形式 <code class="literal">phpfile</code> を適切な PHP 実行ファイルと関連づけます。
     これは、次のコマンドで行います。
     <div class="example-contents screen">
<div class="cdata"><pre>
ftype phpfile=&quot;C:\php\php.exe&quot; -f &quot;%1&quot; -- %~2
</pre></div>     
     </div>
    </p>
   </li>

  </ul>
 </p>

 <p class="para">
  このようにしておくと、どのディレクトリにあるスクリプトを実行するときにも
  PHP 実行ファイルのパスや拡張子 <code class="literal">.PHP</code> をタイプしなくて済むようになります。
  また、スクリプトに渡すパラメータを指定することもできます。
 </p>

 <p class="para">
  次の例は、レジストリの変更の一部を示したものです。これらは手動で行うこともできます。
  <div class="example" id="example-1">
   <p><strong>例1 Registry changes</strong></p>
   <div class="example-contents screen">
<div class="cdata"><pre>
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.php]
@=&quot;phpfile&quot;
&quot;Content Type&quot;=&quot;application/php&quot;

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile]
@=&quot;PHP Script&quot;
&quot;EditFlags&quot;=dword:00000000
&quot;BrowserFlags&quot;=dword:00000008
&quot;AlwaysShowExt&quot;=&quot;&quot;

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\DefaultIcon]
@=&quot;C:\\php\\php-win.exe,0&quot;

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell]
@=&quot;Open&quot;

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell\Open]
@=&quot;&amp;Open&quot;

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell\Open\command]
@=&quot;\&quot;C:\\php\\php.exe\&quot; -f \&quot;%1\&quot; -- %~2&quot;
</pre></div>
   </div>
  </div>
 </p>

 <p class="para">
  これらの変更をすれば、同じコマンドを次のように書くことができます:
  <div class="example-contents screen">
<div class="cdata"><pre>
&quot;C:\PHP Scripts\script&quot; -arg1 -arg2 -arg3
</pre></div>
  </div>
  また、<code class="literal">&quot;C:\PHP Scripts&quot;</code> が環境変数
  <var class="envar">PATH</var> に含まれていれば、次のように書くこともできます:
  <div class="example-contents screen">
<div class="cdata"><pre>
script -arg1 -arg2 -arg3
</pre></div>
  </div>
 </p>

 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="para">
   これらのテクニックを使って
   PHP スクリプトをコマンドラインフィルタとして使おうとすると、
   ちょっとした問題が発生します。
   「コマンドラインフィルタとして使う」とは、たとえば 
   <div class="example-contents screen">
<div class="cdata"><pre>
dir | &quot;C:\PHP Scripts\script&quot; -arg1 -arg2 -arg3
</pre></div>
   </div>
   あるいは
   <div class="example-contents screen">
<div class="cdata"><pre>
dir | script -arg1 -arg2 -arg3
</pre></div>
   </div>
   のように使うということです。
   このようにすると、スクリプトがハングして何も出力されなくなります。
   これをうまく動作させるには、さらにレジストリを変更しなければなりません。
   <div class="example-contents screen">
<div class="cdata"><pre>
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\Explorer]
&quot;InheritConsoleHandles&quot;=dword:00000001
</pre></div>
   </div>

   この件に関する詳細な情報は <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;321788" class="link external">&raquo;&nbsp;Microsoft
   Knowledgebase Article : 321788</a> を参照ください。
   Windows 10 ではこの設定が変更されたようです。Windows 10 をインストールしたデフォルトの状態で、
   コンソールのハンドルが自動的に引き継がれるようになります。この件に関しては、
   <a href="https://social.msdn.microsoft.com/Forums/en-US/f19d740d-21c8-4dc2-a9ab-d5c0527e932b/nasty-file-association-regression-bug-in-windows-10-console?forum=windowssdk" class="link external">&raquo;&nbsp;
   Microsoft のフォーラムへの投稿</a> に説明があります。
  </p>
 </p></blockquote>
</div><?php manual_footer($setup); ?>