第 39章接続処理

注意: 以下は、PHP 3.0.7 版以降に適用されます。

PHP 内部で、接続ステータスが保持されます。これは、次の 3 つの状態をとりえます。

0 - NORMAL
1 - ABORTED
2 - TIMEOUT

通常 PHP が実行されている場合、NORMAL 状態がアクティブになります。リモートクライアントが接続を切った場合、ABORTED 状態フラグが有効になります。通常、リモートクライアントの接続断は、STOP ボタンを押すことにより発生します。 PHP 側の時間制限 (set_time_limit() 参照) にかかった場合、 TIMEOUT 状態フラグが有効になります。

スクリプトを終了させるためにクライアントとの接続を切断するかどうかを決めることが出来ます。時々、出力がどのリモートブラウザにも受信されない場合でも、常にスクリプトの実行完了まで実行する方が便利であることがあります。しかし、デフォルトの動作はリモートクライアントとの接続が断となった際にスクリプトの実行は破棄されます。この動作は、php.ini ディレクティブ ignore_user_abort にて設定できます。同様に同じ意味を有する Apache .conf ディレクティブ "php_value ignore_user_abort" または ignore_user_abort() 関数にて設定することも可能です。 PHP にユーザーによる破棄を無視するように設定していない場合、ユーザが破棄した場合、スクリプトの実行は終了します。一つの例外は、register_shutdown_function() を用いてシャットダウン関数を定義した場合です。シャットダウン関数を定義した場合、リモートユーザーが STOP ボタンを押した後、次にスクリプトが何か出力を行おうとした場合、PHP は接続が破棄されたことを検知し、シャットダウン関数がコールされます。このシャットダウン関数は、スクリプトが正常に終了した際にもコールされます。このため、クライアントが接続を切断した場合に別の動作をさせたい場合には、connection_aborted() 関数を使用することが可能です。この関数は、接続が破棄された場合に、TRUE を返します。

スクリプトは、組み込みのスクリプトタイマーによっても終了することができます。デフォルトのタイムアウトは、30 秒です。これは、php.iniディレクティブ max_execution_time または同義の Apache .confディレクティブ"php_value max_execution_time" を set_time_limit() 関数と同様に用いることにより変更することが可能です。タイマーが切れた時、スクリプトは中断されます。上記のクライアントが接続を切るケースのようにシャットダウン関数が登録されている場合、この関数がコールされます。このシャットダウン関数の中では、 connection_timeout() 関数のコールによりタイムアウトがシャットダウン関数のコールを生じさせるかどうかを確認することができます。この関数は、タイムアウトによりシャットダウン関数がコールされた場合に TRUE を返します。

もう一つ注意すべき点は、状態 ABORTED および TIMEOUT は同時にアクティブにできるということです。これは、PHP をユーザーによる中断を無視するよう設定した場合に可能です。 PHP は、ユーザーが接続を破棄しているが、スクリプトは実行しつづけるということがある可能性があることに注意する必要があります。時間制限にかかって中断される場合、もしあればシャットダウン関数がコールされます。ここで、connection_timeout() および connection_aborted() は TRUE を返します。 connection_status() を使用することにより、一回のコールで両方の状態変数を確認できます。この関数は、アクティブな状態変数のビットフィールドを返します。例えば、状態変数が両方共アクティブな場合、3 を返します。

add a note User Contributed Notes
接続処理

hrgan at melibado dot com
12-Dec-2004 07:08


As it was said, connection handling is very useful when web application need to do something in background. I found it very useful when application need something from database, wrap that data with template, create some html files and save it to filesystem. And all that on server with heavy load. Without connection handling - function ignore_user_abort() - this process can be interrupted by user and final step will never be done.

Lee
18-Sep-2004 10:16


The point mentioned in the last comment isn't always the case.



If a user's connection is lost half way through an order processing script is confirming a user's credit card/adding them to a DB, etc (due to their ISP going down, network trouble... whatever) and your script tries to send back output (such as, "pre-processing order" or any other type of confirmation), then your script will abort -- and this could cause problems for your process.



I have an order script that adds data to a InnoDB database (through MySQL) and only commits the transactions upon successful completion. Without ignore_user_abort(), I have had times when a user's connection dropped during the processing phase... and their card was charged, but they weren't added to my local DB.



So, it's always safe to ignore any aborts if you are processing sensitive transactions that should go ahead, whether your user is "watching" on the other end or not.

ej at campbell *dot* name
12-Feb-2004 01:01


I don't think the first example given below will occur in the real world. 



As long as your order handling script does not output anything, there's no way that it will be aborted before it completes processing (unless it timeouts). PHP only senses user aborts when a script sends output. If there's no output sent to the client before processing completes, which is presumably the case for an order handling script, the script will run to completion.



So, the only time a script can be terminated due to the user hitting stop is when it sends output. If you don't send any output until processing completes, you don't have to worry about user aborts.

pulstar at mail dot com
07-Aug-2003 06:32


These functions are very useful for example if you need to control when a visitor in your website place an order and you need to check if he/she didn't clicked the submit button twice or cancelled the submit just after have clicked the submit button. 

If your visitor click the stop button just after have submitted it, your script may stop in the middle of the process of registering the products and do not finish the list, generating inconsistency in your database.

With the ignore_user_abort() function you can make your script finish everything fine and after you can check with register_shutdown_function() and connection_aborted() if the visitor cancelled the submission or lost his/her connection. If he/she did, you can set the order as not confirmed and when the visitor came back, you can present the old order again.

To prevent a double click of the submit button, you can disable it with javascript or in your script you can set a flag for that order, which will be recorded into the database. Before accept a new submission, the script will check if the same order was not placed before and reject it. This will work fine, as the script have finished the job before.

Note that if you use ob_start("callback_function") in the begin of your script, you can specify a callback function that will act like the shutdown function when our script ends and also will let you to work on the generated page before send it to the visitor.

add a note


	downloads \| documentation \| faq \| getting help \| mailing lists \| \| php.net sites \| links \| my php.net

search for in the