On Mon, 2 Dec 2002, John Coggeshall wrote: > > > >Regarding the confusion factor this is a valid point. The > >error handling docs should clearly describe how the error > >directives such as display_errors, error_reporting, and > >log_errors behave and why a blank page my result. And describe > >ideal production vs. development scenerios. > > We're getting off track here.. The issue is if we should be using > Trigger_error() in the PHPDocs or use die(), or use nothing... > Personally, I don't care which of the two we use -- but I am -1 > At the idea of doing nothing in terms of error handling.
No, this is not off track. This is a larger issue then if one function should be used versus another. I already explained my points. > As far as error handling documentation goes, there are plenty of > Online resources available to the developer. For the e-mail function > We have placed links to outside resources where better information > Can be found for sending MIME e-mails (since they aren't supported > Interally by PHP)... What's wrong with something like that? I know > There are plenty of good tutorials out there that explain and deal > With the concept of good error handling practices. I disagree. The error handling docs need updated. And there is no proposal on the table to use MIME e-mails in most of the examples. Regards, Philip > >The worst case scenerio is people will ask what > >trigger_error() does in which case RTFM will work, hence the > >doc update. I strongly feel this change will greatly benefit > >the PHP community at large. > > > >Regards, > >Philip > > > > > > > >On Mon, 2 Dec 2002, Derick Rethans wrote: > > > >> On Mon, 2 Dec 2002, Gabor Hojtsy wrote: > >> > >> > > > +1 on using trigger_error() in examples, including in > >> > > > +mysql_connect. In > >> > my > >> > > > experience, it needs more exposure to newbies as it is a far > >> > > > more > >> > efficient > >> > > > way of dealing with errors. (And it actually took me a couple > >> > > > years to discover it! :) > >> > > > >> > > I'm -1 on this; don't over complicate examples with > >> > > trigger_error(). Example for functions should be short and the > >> > > main topic should be the function, not trigger_error(). > >> > > >> > So you think, that die() does not complicate the example, while > >> > trigger_error() does? It's just a functions with a longer name :) > >> > >> die("foo"); > >> > >> vs. > >> > >> trigger_error("foo", E_USER_ERROR); > >> > >> is IMO a complication. > >> > >> > We have two aspects we need to consider: > >> > > >> > 1. Encourage safe coding > >> > 2. Provide short and easy to understand examples > >> > > >> > If we leave errors unhandled in examples, that is simple, > >but harms > >> > the developers. I do think, that using too much error > >handling code > >> > in examples hurts, but none is not better... > >> > >> right, die() works fine for that. > >> > >> Derick > >> > >> -- > >> > >> > >--------------------------------------------------------------- > >---------- > >> Derick Rethans > >http://derickrethans.nl/ > >> PHP Magazine - PHP Magazine for > >Professionals http://php-mag.net/ > >> > >---------------------------------------------------------------------- > >> --- > >> > >> > >> -- > >> PHP Documentation Mailing List (http://www.php.net/) > >> To unsubscribe, visit: http://www.php.net/unsub.php > >> > > > > > > > -- > PHP Documentation Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php