Aπομακρυσμένα αρχεία
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...
Χειρισμός Συνδέσεων
Note: Τα ακόλουθα ισχύουν από την 3.0.7 και μετά.
Εσωτερικά στην PHP ένα status σύνδεσης (connection status) διατηρείται. Υπάρχουν 3 δυνατές καταστάσεις:
- 0 - NORMAL
- 1 - ABORTED
- 2 - TIMEOUT
Όταν ένα PHP script εκτελείται, κανονικά η κατάσταση NORMAL είναι ενεργή. Αν ένας remote (απομακρυσμένος) client αποσυνδεθεί, η ABORTED σημαία κατάστασης ενεργοποιείται. Μια αποσύνδεση ενός remote client συνήθως προκαλείται όταν ο χρήστης πατήσει το κουμπί STOP. Αν το όριο χρόνου της PHP (δείτε την set_time_limit()) περαστεί, η TIMEOUT σημαία κατάστασης ενεργοποιείται.
Μπορείτε να αποφασίσετε αν θέλετε μια αποσύνδεση ενός client να προκαλεί το script σας να σταματά. Κάποτε είναι βολικό να έχετε πάντα τα scripts σας να τρέχουν μέχρι τέλους ακόμη και αν δεν υπάρχει κάποιος remote browser να λαμβάνει την έξοδο. Η προκαθορισμένη συμπεριφορά όμως είναι το script σας να τερματίζει όταν ο remote client αποσυνδέεται. Αυτή η συμπεριφορά μπορεί να οριστεί μέσω του ignore_user_abort directive στο php.ini όπως και μέσω του αντίστοιχου "php_value ignore_user_abort" Apache .conf directive ή με την ignore_user_abort() συνάρτηση. Αν δεν πείτε της PHP να αγνοήσει μια αποσύνδεση ενός χρήστη και ο χρήστης αποσυνδεθεί, το script σας θα τερματίσει. Η μόνη εξαίρεση είναι αν έχετε κάνει register μια shutdown συνάρτηση χρησιμοποιώντας την register_shutdown_function(). Με μια shutdown συνάρτηση, όταν ο remote χρήστης πατήσει το STOP κουμπί, την επόμενη φορά που το script θα προσπαθήσει να έχει κάτι στην έξοδο, η PHP θα ανιχνεύσει πως η σύνδεση έχει τερματιστεί και η shutdown συνάρτηση θα καλεστεί. Αυτή η shutdown συνάρτηση θα καλεστεί στο τέλος της κανονικής εκτέλεσης του script σας, έτσι για να κάνετε κάτι διαφορετικό στην περίπτωση που ένας client αποσυνδέεται μπορείτε να χρησιμοποιήσετε την connection_aborted() συμνάρτηση. Αυτή η συνάρτηση θα επιτστρέψει TRUE αν η σύνδεση έχει τερματιστεί (aborted).
Το script σας μπορεί επίσης να τερματιστεί από τον ενσωματωμένο timer (χρονομετρητή) των script. Ο προκαθορισμένος timeout χρόνος είναι 30 δευτερόλεπτα. Μπορεί να αλλαχτεί χρησιμοποιώντας το max_execution_time directive στο php.ini ή το αντίστοιχο "php_value max_execution_time" directive στα Apache .conf όπως επίσης και με την συνάρτηση set_time_limit(). Όταν ο timer λήξει, το script θα τερματιστεί και, όπως και στην παραπάνω περίπτωση αποσύνδεσης του client, αν μια shutdown συνάρτηση έχει καταχωρηθεί (registered) θα καλεστεί. Μέσα σε αυτή την shutdown συνάρτηση μπορείτε να ελέγξετε αν ένα timeout ήταν το αίτιο της κλήσης της shutdown συνάρτησης, καλώντας την συνάρτηση connection_timeout(). Αυτή η συνάρτηση επιστρέφει TRUE αν ένα timeout δημιούργησε την κλήση της shutdown συνάρτησης.
Κάτι που αξίζει να σημειωθεί είναι ότι τόσο η ABORTED όσο και η TIMEOUT κατάσταση μπορούν να είναι ενεργές την ίδια στιγμή. Αυτό είναι πιθανόν αν πείτε στην PHP να αγνοεί τα abort των χρηστών. Η PHP ακόμη θα σημειώνει το γεγονός ότι κάποιος χρήστης μπορεί να έχει διακόψει τη σύνδεση, αλλά το script θα συνεχίσει να τρέχει. Αν τότε φτάσει το όριο χρόνου θα τερματιστεί και η shutdown συνάρτηση σας, αν υπάρχει, θα καλεστεί. Σε αυτό το σημείο θα βρείτε ότι η connection_timeout() και η connection_aborted() επιστρέφουν TRUE. Μπορείτε επίσης να ελέγξετε και τις δύο καταστάσεις σε μία κλήση χρησιμοποιώντας την connection_status(). Αυτή η συνάρτηση επιστρέφει ένα πεδίο με bits (bitfield) των ενεργών καταστάσεων. Έτσι, αν και οι δύο καταστάσεις είναι ενεργές για παράδειγμα, θα επιστρέψει 3.
add a note
User Contributed NotesΧειρισμός Συνδέσεων
Jean Charles MAMMANA
01-Apr-2008 02:25
01-Apr-2008 02:25
Anonymous
13-Nov-2007 02:06
13-Nov-2007 02:06
in regards of posting from:
arr1 at hotmail dot co dot uk
if 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();
arr1 at hotmail dot co dot uk
14-Nov-2006 11:51
14-Nov-2006 11:51
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 hu
Posted the original solution:
<?php
header("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(); // optional
ob_start();
echo ('Text the user will see');
$size = ob_get_length();
header("Content-Length: $size");
ob_end_flush(); // Strange behaviour, will not work
flush(); // Unless both are called !
// Do processing here
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.11
Mozilla Firefox 1.81
bg at ms dot com
22-Sep-2005 06:42
22-Sep-2005 06:42
Confirmed. User presses STOP button. This sends a RST packet and closes the connection. PHP is most certainly immediately affected (i.e., the script is stopped, whether or not any output is pending for the user, or even if script is just grinding away on a database without having output anything).
ignore_user_abort() exists to prevent this.
If user STOPS, script ignores the RST and runs to completion (the output is apparently ignored by apache and not sent to the user, who sent the RST and closed the TCP connection). If user's connection just vanishes (isp problem, disconnect, whatever), and there is no RST sent by user, then eventually the script will timeout.
hrgan at melibado dot com
12-Dec-2004 11:08
12-Dec-2004 11: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 03:16
18-Sep-2004 03: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 05:01
12-Feb-2004 05: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
06-Aug-2003 11:32
06-Aug-2003 11: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.