Bağlantı yönetimi
PHP içinde yerleşik olarak bağlantı durumu saklanır. Olası 4 durum vardır:
- 0 - NORMAL
- 1 - ABORTED
- 2 - TIMEOUT
- 3 - ABORTED ve TIMEOUT
PHP betiği normal olarak çalıştığında, NORMAL durumu etkindir.
Eğer uzak istemci bağlantıyı keserse ABORTED durumu etkin olur.
Uzak istemci bağlantı kesilmesi genellikle kullanıcının DUR düğmesine
basmasından kaynaklanır. Eğer PHP tarafından bir zaman sınırı
(set_time_limit() işlevine bakınız) tetiklendiyse,
TIMEOUT durumu etkin olur.
Kullanıcının bağlantı kesmesiyle betiğinizin iptal edilip edilmeyeceğine
karar verebilirsiniz. Bazen uzak tarayıcı çıktıyı almasa da betiğinizin
işini bitirinceye kadar çalışmasını gerektiren durumlar olabilir. Öntanımlı
davranış uzak istemci bağlantıyı kestiğinde betik çalışmasının iptal
edilmesidir. Bu davranış şekli ignore_user_abort
php.ini yönergesi veya ona ilişkin
php_value ignore_user_abort
Apache httpd.conf
yapılandırma yönergesi veya ignore_user_abort() işlevi ile
belirlenebilir. Eğer PHP'ye kullanıcı iptallerini gözardı etmesini
söylemezseniz ve kullanıcı iptal ederse betiğiniz sonlanır. Tek istisnası
register_shutdown_function() işleviyle kapatma işlevinin
kayıtlanmasıdır. Bir kapatma işlevi ile, uzak kullanıcı DUR düğmesine
bastığında, betiğinizin sonraki çıktılama denemesinde PHP bağlantının iptal
edildiğini tespit eder ve kapatma işlevi çağrılır. Bu kapatma işlevi ayrıca
normal olarak sonlandırmada betiğinizin sonunda çağrılacaktır, istemci
tarafından bağlantı iptalinde farklı birşey yapmak için
connection_aborted() işlevini kullanabilirsiniz. Eğer
bağlantı iptal edilirse bu işlev true
döndürecektir.
Betiğinizi yerleşik betik zamanlayıcı ile de sonlandırabilirsiniz.
Öntanımlı zaman aşımı 30 saniyedir. Bu max_execution_time
php.ini yönergesi veya ilişkili php_value
max_execution_time
Apache httpd.conf yapılandırma yönergesi veya
set_time_limit() işlevi ile değiştirilebilir. Zaman
aşımında betik iptal edilir ve yukarıdaki istemci bağlantı kesilmesindeki
gibi, eğer kayıtlı bir kapatma işlevi varsa çağrılır. Bu kapatma işlevi
içinde connection_status() işlevi ile kapatma işlevinin
zaman aşımı nedeniyle mi çağrıldığını denetleyebilirsiniz. Kapatma
işlevinin çağrılmasına zaman aşımı neden olduysa bu işlev 2 döndürür.
ABORTED ve TIMEOUT durumlarının aynı zamanda etkin olabileceğine dikkat
edilmesi gerekir. Eğer PHP'ye kullanıcı iptallerini gözardı etmesini
söylediyseniz bu mümkündür. PHP kullanıcının bağlantıyı koparmış
olabileceğini bilir, fakat betik çalışmaya devam eder. Eğer zaman sınırına
ulaşırsa çalışması iptal edilir ve kapatma işleviniz varsa çağrılır. Bu
noktada connection_status() işlevinin 3 döndürdüğünü
göreceksiniz.
tom lgold2003 at gmail dot com ¶15 years ago
hey, thanks to arr1, and it is very useful for me, when I need to return to the user fast and then do something else.When using the codes, it nearly drive me mad and I found another thing that may affect the codes:Content-Encoding: gzipThis is because the zlib is on and the content will be compressed. But this will not output the buffer until all output is over.So, it may need to send the header to prevent this problem.now, the code becomes:<?phpob_end_clean();header("Connection: close\r\n");header("Content-Encoding: none\r\n");ignore_user_abort(true); ob_start();echo ('Text user will see');$size = ob_get_length();header("Content-Length: $size");ob_end_flush(); flush(); ob_end_clean();sleep(5);echo('Text user will never see');?>
arr1 at hotmail dot co dot uk ¶18 years ago
Closing the users browser connection whilst keeping your php script running has been an issue since 4.1, when the behaviour of register_shutdown_function() was modified so that it would not automatically close the users connection.sts at mail dot xubion dot huPosted the original solution:<?phpheader("Connection: close");ob_start();phpinfo();$size=ob_get_length();header("Content-Length: $size");ob_end_flush();flush();sleep(13);error_log("do something in the background");?>Which works fine until you substitute phpinfo() for echo ('text I want user to see'); in which case the headers are never sent!The solution is to explicitly turn off output buffering and clear the buffer prior to sending your header information.example:<?php ob_end_clean(); header("Connection: close"); ignore_user_abort(); ob_start(); echo ('Text the user will see'); $size = ob_get_length(); header("Content-Length: $size"); ob_end_flush(); flush(); sleep(30); echo('Text user will never see');?> Just spent 3 hours trying to figure this one out, hope it helps someone :)Tested in:IE 7.5730.11Mozilla Firefox 1.81
Lee ¶20 years ago
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.
mheumann at comciencia dot cl ¶12 years ago
I had a lot of problems getting a redirect to work, after which my script was intended to keep working in the background. The redirect to another page of my site simply would only work once the original page had finished processing.I finally found out what was wrong:The session only gets closed by PHP at the very end of the script, and since access to the session data is locked to prevent more than one page writing to it simultaneously, the new page cannot load until the original processing has finished.Solution:Close the session manually when redirecting using session_write_close():<?phpignore_user_abort(true);set_time_limit(0);$strURL = "PUT YOUR REDIRCT HERE";header("Location: $strURL", true);header("Connection: close", true);header("Content-Encoding: none\r\n");header("Content-Length: 0", true);flush();ob_flush();session_write_close();sleep(100);exit;?>But careful:Make sure that your script doesn't write to the session after session_write_close(), i.e. in your background processing code. That won't work. Also avoid reading, remember, the next script may already have modified the data.So try to read out the data you need prior to redirecting.
Marco ¶8 years ago
The CONNECTION_XXX constants that are not listed here for some reason are:0 = CONNECTION_NORMAL1 = CONNECTION_ABORTED2 = CONNECTION_TIMEOUT3 = CONNECTION_ABORTED & CONNECTION_TIMEOUTNumber 3 is effectively tested like this:if (CONNECTION_ABORTED & CONNECTION_TIMEOUT) echo 'Connection both aborted and timed out';
a1n2ton at gmail dot com ¶15 years ago
PHP changes directory on connection abort so code like this will not do what you want:<?phpfunction abort(){ if(connection_aborted()) unlink('file.ini');}register_shutdown_function('abort');?>actually it will delete file in apaches's root dir so if you want to unlink file in your script's dir on abort or write to it you have to store directory<?phpfunction abort(){ global $dsd; if(connection_aborted()) unlink($dsd.'/file.ini');}register_shutdown_function('abort');$dsd=getcwd();?>
Ilya Penyaev ¶12 years ago
I was quite stuck when trying to make my script redirect the client to another URL and then continue processing. The reason was php-fpm. All possible buffer flushes did not work, unless I called fastcgi_finish_request();For example:<?php ignore_user_abort(true); header("Location: ".$redirectUrl, true); header("Connection: close", true); header("Content-Length: 0", true); ob_end_flush(); flush(); fastcgi_finish_request(); sleep (5); ?>
Anonymous ¶13 years ago
This simple function outputs a string and closes the connection. It considers compression using "ob_gzhandler"
It took me a little while to put this all together, mostly because setting the encoding to none, as some people noted here, didn't work.
<?php
function outputStringAndCloseConnection2($stringToOutput)
{
set_time_limit(0);
ignore_user_abort(true);
if(!ob_start("ob_gzhandler"))
ob_start();
echo $stringToOutput;
$size = ob_get_length();
header("Content-Length: $size");
header('Connection: close');
ob_end_flush();
ob_flush();
flush();
if (session_id()) session_write_close();
}
?>
Anonymous ¶17 years ago
in regards of posting from:arr1 at hotmail dot co dot ukif you use/write sessions you need to do this before:(otherwise it does not work)session_write_close();and if wanted:ignore_user_abort(TRUE);instead of ignore_user_abort();
pulstar at mail dot com ¶22 years ago
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.
Jean Charles MAMMANA ¶17 years ago
connection_status() return ABORTED state ONLY if the client disconnects gracefully (with STOP button). In this case the browser send the RST TCP packet that notify PHP the connection is closed.But.... If the connection is stopped by networs troubles (wifi link down by exemple) the script doesn't know that the client is disconnected :(I've tried to use fopen("php://output") with stream_select() on writting to detect write locks (due to full buffer) but php give me this error : "cannot represent a stream of type Output as a select()able descriptor"So I don't know how to detect correctly network trouble connection...