Το php.ini εξηγημένο: δομή, επίπεδα και προτεραιότητα

Εν συντομία: Το php.ini είναι το κεντρικό αρχείο διαμόρφωσης της PHP. Η PHP το διαβάζει κατά την εκκίνηση, στις μονάδες διακομιστή μία φορά, στο CGI και στο CLI σε κάθε κλήση. Προστίθενται πρόσθετα αρχεία από έναν κατάλογο σάρωσης, ρυθμίσεις στο pool του FPM ή στον Apache, .htaccess ή .user.ini και ini_set() στον κώδικα. Ποιο επίπεδο επιτρέπεται να αλλάξει μια τιμή, ορίζει ο τρόπος αλλαγής της, για παράδειγμα INI_SYSTEM ή INI_PERDIR. Τιμές μέσω php_admin_value δεν μπορεί πλέον να τις παρακάμψει η εφαρμογή.

Τι είναι το php.ini;

Το php.ini είναι ένα αρχείο κειμένου με εγγραφές της μορφής name = wert. Ορίζει πώς συμπεριφέρεται η PHP: πόση μνήμη επιτρέπεται να χρησιμοποιεί ένα σενάριο, αν τα σφάλματα εμφανίζονται στον browser, πώς λειτουργούν οι συνεδρίες και ποιες επεκτάσεις φορτώνονται. Τα σχόλια ξεκινούν με τον χαρακτήρα ; (semicolon).

Σύμφωνα με το εγχειρίδιο της PHP, το αρχείο διαβάζεται κατά την εκκίνηση της PHP. Σε μονάδες διακομιστή όπως το mod_php αυτό συμβαίνει μόνο μία φορά, κατά την εκκίνηση του διακομιστή ιστού, στο CGI και στο CLI σε κάθε κλήση. Το PHP-FPM διαβάζει τη διαμόρφωσή του κατά την εκκίνηση και κατά την επαναφόρτωση της υπηρεσίας. Μια αλλαγή χωρίς επανεκκίνηση ή reload δεν ισχύει γι' αυτό συνήθως.

Από την PHP 8.3 μια εγγραφή μπορεί σύμφωνα με το εγχειρίδιο να παραπέμπει σε μεταβλητή περιβάλλοντος με εναλλακτική τιμή:

memory_limit = ${PHP_MEMORY_LIMIT}
max_execution_time = ${PHP_MAX_EXECUTION_TIME:-30}

Πού αναζητά η PHP το php.ini;

Το εγχειρίδιο περιγράφει μια σταθερή σειρά. Πρώτα ισχύει μια ρητά ορισμένη διαδρομή, για παράδειγμα το PHPIniDir στον Apache ή η επιλογή -c στο CGI και στο CLI. Διαφορετικά η PHP χτίζει μια διαδρομή αναζήτησης από:

1. τη μεταβλητή περιβάλλοντος PHPRC,
2. στα Windows την εγγραφή μητρώου IniFilePath,
3. τον τρέχοντα κατάλογο εργασίας, εκτός από SAPI που το απενεργοποιούν, όπως το CLI,
4. τον κατάλογο του δυαδικού αρχείου PHP ή της μονάδας,
5. τη διαδρομή --with-config-file-path που ορίστηκε κατά τη μεταγλώττιση.

Σε αυτή τη διαδρομή αναζήτησης η PHP ψάχνει πρώτα ένα αρχείο php-SAPI.ini, για παράδειγμα php-cli.ini, και μόνο μετά το php.ini. Στη συνέχεια η PHP διαβάζει όλα τα αρχεία .ini από τον κατάλογο σάρωσης, που ορίζεται μέσω του PHP_INI_SCAN_DIR ή κατά τη μεταγλώττιση μέσω του --with-config-file-scan-dir, με αλφαβητική σειρά. Ποια αρχεία φορτώθηκαν, δείχνει το php --ini ή η συνάρτηση php_ini_scanned_files().

php --ini
php -r 'var_dump(php_ini_loaded_file(), php_ini_scanned_files());'

Και οι δύο εντολές δείχνουν την κατάσταση της γραμμής εντολών. Για τον ιστότοπο μπορεί να ισχύει άλλο αρχείο, επειδή κάθε SAPI μπορεί να έχει τη δική του διαμόρφωση· περισσότερα στη σελίδα Το SAPI εξηγημένο.

Τρόποι αλλαγής: ποιος επιτρέπεται να ορίσει ποια τιμή;

Δεν επιτρέπεται κάθε ρύθμιση να οριστεί παντού. Το εγχειρίδιο αντιστοιχίζει κάθε οδηγία σε έναν τρόπο αλλαγής:

Παραδείγματα από το εγχειρίδιο: το memory_limit έχει τρόπο INI_ALL και προεπιλογή 128M, το post_max_size έχει INI_PERDIR και προεπιλογή 8M, το upload_max_filesize έχει INI_PERDIR και προεπιλογή 2M. Το expose_php επιτρέπεται να βρίσκεται μόνο στο php.ini.

Τα αρχεία .user.ini διαβάζονται σύμφωνα με το εγχειρίδιο μόνο από τα SAPI CGI και FastCGI, άρα και από το PHP-FPM. Η PHP τα αναζητά από τον κατάλογο του σεναρίου προς τα πάνω έως το Document Root και τα ξαναδιαβάζει από προεπιλογή το πολύ κάθε 300 δευτερόλεπτα (user_ini.cache_ttl). Στο mod_php αυτόν τον ρόλο αναλαμβάνει το .htaccess.

Ποια τιμή ισχύει στο τέλος; Τα επίπεδα κατά προτεραιότητα

Απλοποιημένα ισχύει: όσο αργότερα ενεργεί ένα επίπεδο, τόσο πιθανότερο είναι να επικρατήσει η τιμή του, εφόσον το επιτρέπει ο τρόπος αλλαγής.

1. php.ini του εκάστοτε SAPI
2. Πρόσθετα αρχεία από τον κατάλογο σάρωσης, αλφαβητικά
3. Διαμόρφωση διακομιστή: pool FPM με php_value ή php_admin_value, VirtualHost του Apache
4. Επίπεδο καταλόγου: .htaccess στο mod_php, .user.ini στο FPM και στο CGI
5. Χρόνος εκτέλεσης: ini_set() στον κώδικα της εφαρμογής

Η εξαίρεση είναι καθοριστική: τιμές μέσω php_admin_value ή php_admin_flag δεν μπορούν σύμφωνα με το εγχειρίδιο να παρακαμφθούν με ini_set(). Έτσι οι διαχειριστές κλειδώνουν ρυθμίσεις σχετικές με την ασφάλεια απέναντι στην εφαρμογή. Αναλυτική περιγραφή υπάρχει στη σελίδα php_admin_value: κλείδωμα ρυθμίσεων απέναντι σε παράκαμψη.

Το php.ini μετά το PHP2Shell: τι άλλαξε

Τα προσωρινά μέτρα του php.net για το PHP2Shell είναι σχεδόν όλα ρυθμίσεις INI: memory_limit=-1 κλειδωμένο απέναντι σε παράκαμψη, περιορισμένο post_max_size, session.upload_progress.enabled=0 και στην PHP 8.5 fatal_error_backtraces=0. Το php.net τονίζει ότι το session.upload_progress.enabled δεν πρέπει να οριστεί μέσω ini_set() ή .user.ini, αλλά στο php.ini, στο pool του FPM ή στη διαμόρφωση του διακομιστή, με επακόλουθη επανεκκίνηση όλων των workers. Η πλήρης λίστα βρίσκεται στη σελίδα Άμεσα μέτρα όταν δεν μπορείτε ακόμη να εφαρμόσετε patch.

Με τις διορθωμένες εκδόσεις 8.5.12, 8.4.27, 8.3.36 και 8.2.35 άλλαξε σύμφωνα με το εγχειρίδιο και το memory_limit: είναι πλέον ένα ήπιο όριο. Η νέα ρύθμιση memory_hard_limit_percent ορίζει ένα αυστηρό όριο. Χωρίς δική σας τιμή ισούται με το διπλάσιο του memory_limit, για περισσότερα από 1G με την τιμή συν 1G. Αν ξεπεραστεί, η διεργασία τερματίζεται αμέσως με κατάσταση εξόδου 137. Πώς θα επιλέξετε λογικά και τα δύο όρια, εξηγεί η σελίδα Σωστός ορισμός του memory_limit.

Πώς βοηθά συγκεκριμένα η PHP SOS;

• Εντοπισμός ισχυουσών τιμών: Διαβάζουμε για κάθε SAPI ποια αρχεία φορτώνονται και ποια τιμή ισχύει στο τέλος.
• Τακτοποίηση επιπέδων: Αφαιρούμε αντικρουόμενες εγγραφές από πάνελ, pools, .htaccess και .user.ini.
• Ορισμός κλειδωμάτων: Στο πλαίσιο της θωράκισης διακομιστή ορίζουμε τιμές σχετικές με την ασφάλεια μέσω php_admin_value.
• Τεκμηρίωση: Καταγράφουμε τις ρυθμίσεις και την επανεκκίνηση, ώστε η κατάσταση να αποδεικνύεται αργότερα.

Συχνές ερωτήσεις

Πηγές

• Εγχειρίδιο PHP: Το αρχείο διαμόρφωσης
• Εγχειρίδιο PHP: Τρόποι αλλαγής των ρυθμίσεων INI
• Εγχειρίδιο PHP: Αρχεία .user.ini
• Εγχειρίδιο PHP: Βασικές ρυθμίσεις