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