Actief Topic: [PHP] Error afhandeling

Het is altijd mogelijk dat er een fout optreed in je website. Er zijn een aantal verschillende foutmeldingen. Naast de foutmeldingen van PHP zelf, heb je ook mysql errors, en je kunt zelf je eigen fouten maken. Maar het is natuurlijk vervelend om de bezoeker op te schepen met een lelijke foutmelding waarmee je de bezoeker alleen maar afschrikt. In deze tutorial wil ik meerdere dingen uitleggen: 1. De werking van error reporting 2. De soorten foutmeldingen 3. MySQL errors 4. Het maken van eigen fouten 5. Fouten netjes afhandelen 6. Fouten opslaan naar een logbestand. [b]1. De werking van error reporting[/b] Standaard zal PHP de grote fouten (errors) weergeven, en het script afbreken. Dit is vaak noodzakelijk omdat je met een 'kapot' script weinig kan. Minder erge fouten (warnings) zal PHP ook weergeven, maar het script wordt dan niet afgebroken. Ook zijn er meldingen die niet belangrijk zijn, maar eerder wijzen op een slordigheids foutje van de programmeur. Sommige hosts hebben error reporting helemaal uitgeschakeld. In sommige gevallen wil je dat het wel aan staat, en daarvoor kan je dit gebruiken: [code=php]<?php // Zet error reporting aan. Weergeef alle meldingen, behalve E_NOTICE. error_reporting(E_ALL ^ E_NOTICE); // Zet error reporting aan in de ini. ini_set('error_reporting', E_ALL); ?>[/code] [b]2. De soorten foutmeldingen[/b] Om de tutorial kort en krachtig te houden ga ik deze soorten niet bespreken. Ik verwijs naar de documentatie van php.net. http://nl2.php.net/manual/en/errorfunc.constants.php Even in het kort. De soorten die beginnen met E_USER zijn door de gebruiker zelf gegeneerd met behulp van trigger_error(). De overige niet. [b]3. MySQL errors[/b] MySQL heeft zelf ook fouten. Standaard zie je alleen een fout die niet zoveel zegt over wat er echt mis is. Om erachter te komen wat er echt mis is kan je de functie mysql_error() gebruiken. Bijvoorbeeld: [code=php]<?php mysql_query("Hier je SQL") or die(mysql_error()); ?>[/code] De 'or' spreekt voor zich. De die() breekt het script af, en weergeeft de mysql error. [b]4. Het maken van eigen fouten[/b] In alinea 2 heb ik al iets verteld over trigger_error en E_USER. Hiermee kan je dus zelf je eigen fouten maken. Het prinicipe is simpel. [code=php]<?php trigger_error("Hier je foutmelding", E_USER_ERROR); ?>[/code] De E_USER_ERROR doet dus het zelfde als E_ERROR, alleen is deze door het script zelf getriggerd. [b]5. Fouten netjes afhandelen[/b] Als je geen lelijke error op je site wil, maar in plaats daarvan je eigen melding kan je hetvolgende script gebruiken: [code=php]<?php function error_handler( $soort, $errorstring, $bestand, $regel) { // Kijken naar het soort switch($soort) { case E_ERROR: // Foutmelding $fout = "Er is een fout opgetreden op regel <b>".$regel."</b> in het bestand \"". $bestand."\": "; $fout .= "<p>". $errorstring ."</p>"; // Afhandelen die($fout); break; case E_WARNING: // Foutmelding echo "Er is een fout opgetreden op regel <b>".$regel."</b> in het bestand \"". $bestand."\": "; // Afhandelen return true; break; } } // Error handler installeren set_error_handler("error_handler"); ?>[/code] Ik heb nu twee voorbeelden gegeven. Dat moet al een deel verklaren. De 'return true' in de functie zegt dat PHP zich verder niet meer moet bemoeien met die fout. Als je 'return false' gebruikt of niks, dan zal PHP gewoon de standaard error afhandeling vervolgen. De 'break' is om de 'case' te stoppen. Doe je dat niet, dan zal php doorgaan naar de volgende 'case'. In dit geval is de break overbodig omdat in beide gevallen de functie sowieso niet meer verder gaat door een die of return. [b]6. Fouten opslaan naar een logbestand[/b] Als bij de bezoeker een fout optreed, is het handig voor de webmaster om te weten welke fout er heeft opgetreden. Daarom maak ik een simpele functie om te loggen. [code=php]<?php define('LOG_BESTAND', 'log/error.php'); function writelog($msg) { // Kijken of de map bestaat. if(is_dir(dirname(LOG_BESTAND))) { $lstring = ""; // Kijken of het logbestand bestaat if(!file_exists(LOG_BESTAND)) { // Nee dus. // Maak een exit code om te voorkomen dat bezoekers het bestand kunnen lezen. $lstring = "<?php\nexit;\n?>\n"; } // Bestand openen, indien het bestand niet bestaat de proberen aan te maken. Let op voor de juiste rechten in de map! (of maak het bestand handmatig aan met // de juiste rechten. if($IO = fopen(LOG_BESTAND, 'a+')) { // Logstring maken. $lstring .= '['.date('d-m-Y H:i:s').'] ['.$_SERVER['REMOTE_ADDR'] .'] '. $msg . "\n"; // Logstring schrijven fwrite($IO, $lstring); // Logbestand sluiten fclose($IO); } else { die ("Kon het logbestand niet openen om te schrijven."); } } else { die ("De map van het logbestand bestaat niet."); } } function error_handler( $soort, $errorstring, $bestand, $regel) { // Foutmeldingen maken $fout_log = '[regel: '. $regel.'] [url: '. $_SERVER['REQUEST_URI'].'] [bestand: '. $bestand.']: '.$errorstring; $fout_gasten = 'Er is een interne fout opgetreden. Onze excuses voor dit ongemak.'; // Alle fouten naar het log bestand schrijven. Wil je niet alle meldingen loggen, dan kan je dit in de switch bij de juiste cases zetten. writelog($fout_log); // Kijken naar het soort switch($soort) { // Errors case E_ERROR: case E_USER_ERROR: // Weergeven en sterven die($fout_gasten); // Waarschuwingen case E_WARNING: case E_USER_WARNING: // Weergeven echo $fout; break; } // Zorgen dat PHP niks meer doet met deze meldingen return true; } // Error handler installeren set_error_handler("error_handler"); // Een test. Ik ga ervan uit dat je hier een database connectie hebt : mysql_query("SELECT * FROM `test`") or trigger_error(mysql_error(), E_USER_WARNING); ?>[/code] De testquery is goed, alleen heb ik geen verbinding met de database. Daarom krijg ik een fout. Open je het logbestand, dan ziet het er zo uit: [code]<?php exit; ?> [09-08-2009 14:05:08] [127.0.1.1] [regel: 66] [url: /~koen/Test/error-log.php] [bestand: /var/www/Users/koen/public_html/Test/error-log.php]: mysql_query() [<a href='function.mysql-query'>function.mysql-query</a>]: Access denied for user 'www-data'@'localhost' (using password: NO) [09-08-2009 14:05:08] [127.0.1.1] [regel: 66] [url: /~koen/Test/error-log.php] [bestand: /var/www/Users/koen/public_html/Test/error-log.php]: mysql_query() [<a href='function.mysql-query'>function.mysql-query</a>]: A link to the server could not be established [09-08-2009 14:05:08] [127.0.1.1] [regel: 66] [url: /~koen/Test/error-log.php] [bestand: /var/www/Users/koen/public_html/Test/error-log.php]: Access denied for user 'www-data'@'localhost' (using password: NO)[/code] Wil je een per maand een nieuw logbestand, kan je natuurlijk de datum in de bestandsnaam verwerken. Bijvoorbeeld: [code=php]define('LOG_BESTAND', 'log.'.date('M-Y').'.php');[/code] Dan krijg je iedere maand een nieuw logbestand. Een bestandsnaam wordt dan bijvoorbeeld: 'log.Aug-2009.php'. Eventueel zou je nog kunnen zorgen dat logbestanden van een jaar oud automatisch worden verwijderd.