Re: coding standards - draft

From: Date: Wed, 09 Jan 2002 10:16:03 +0000
Subject: Re: coding standards - draft
References: 1 2 3  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969340983@lists.php.net to get a copy of this message
> Thanks for your additions. Looking forward for more.....:-) > I tried to incorporate them, also the contributions from the other people. > Have a look online http://www.holliwell.de/draft/draft1 > or download at http://www.holliwell.de/draft/draft1.tar.gz > (about 4kb) > Keep in mind it`s a draft and just an attempt to gather the ideas and > contributions :-). Feel free to comment, change and so on .... I think it is just time to heat up the discussion about this. Some additions I can think of: --- Error handling: die is not right for production, but a complex if is not needed, either one can use a user defined error function, or more easily can use trigger_error(), or user_error(), which adds much more options and possibilities than using die, and is completely appropriate to use in production: $conn = mysql_connect(...) or user_error("Cannot connect", E_USER_ERROR); This will cause the script to stop running, and to print out a PHP style error message by default. But php.ini can be set up to redirect this to syslog, or use a special error handling function. IMHO use this way of error handling in examples. Why we use it, should be explained in the "error handling" and/or "about the manual" parts. --- Sample outputs: <para> in exmaple is not allowed, so the screen example in your draft wont work with docbook. Need to invent some other type of output. --- It would be nice to hear what others think about this draft, as we can only make things standards after proper discussion, but it would be nice to have a standard in a short term. Goba

« previous php.doc (#969340983) next »