{"id":1455,"date":"2018-01-19T19:22:51","date_gmt":"2018-01-19T19:22:51","guid":{"rendered":"http:\/\/goofy-trucks.flywheelsites.com\/pear-primer-page-2\/"},"modified":"2018-01-19T19:24:48","modified_gmt":"2018-01-19T19:24:48","slug":"pear-primer-page-2","status":"publish","type":"post","link":"https:\/\/phpbuilder.com\/pear-primer-page-2\/","title":{"rendered":"PEAR Primer Page 2"},"content":{"rendered":"
\n
\n
By Joe Stump<\/div>\n
on December 26, 2002<\/div>\n<\/p><\/div>\n
\n

The PEAR Class<\/h2>\n
\nThe base PEAR class is fairly abstracted and shouldn’t be used on its own, however, it is a great class to
\nbuild your classes off of. It’s major feature is that it imitates destructors. With PHP5 on its way this will
\nbe void, since PHP5 will support destructors natively, I believe. The class file for PEAR also includes the
\nPEAR_Error class, which we will talk about in more detail at a later time. First let’s discuss basing your
\nclasses on PEAR. We are going to start by creating our own specific base class and then extending that to a
\nuser class to be used on a site. Remember to document your classes using PHPDoc<\/a>!<\/div>\n
\n<\/p>\n

<?php
\n
\u00a0\u00a0<\/span>require_once(<\/span>'PEAR.php'<\/span>);
\n
\u00a0\u00a0require_once(<\/span>'DB.php'<\/span>);
\n
\u00a0\u00a0require_once(<\/span>'Log.php'<\/span>);<\/p>\n

\u00a0\u00a0<\/span>\/**
\n
\u00a0\u00a0*\u00a0Default\u00a0PEAR\u00a0DSN
\n
\u00a0\u00a0*\u00a0
\n
\u00a0\u00a0*\u00a0@author\u00a0Joe\u00a0Stump\u00a0<joe@joestump.net>
\n
\u00a0\u00a0*\u00a0@global\u00a0string\u00a0BASE_PEAR_DSN
\n
\u00a0\u00a0*\u00a0@access\u00a0public
\n
\u00a0\u00a0*\u00a0@see\u00a0Base::Base(),\u00a0Base::$db
\n
\u00a0\u00a0*\/
\n
\u00a0\u00a0<\/span>define<\/span>(<\/span>'BASE_PEAR_DSN'<\/span>,<\/span>'mysql:\/\/root:@localhost\/base'<\/span>);<\/p>\n

\u00a0\u00a0<\/span>\/**
\n
\u00a0\u00a0*\u00a0Base\u00a0Class
\n
\u00a0\u00a0*
\n
\u00a0\u00a0*\u00a0Our\u00a0base\u00a0class\u00a0will\u00a0hold\u00a0only\u00a0the\u00a0basic\u00a0necessities\u00a0that\u00a0all
\n
\u00a0\u00a0*\u00a0of\u00a0our\u00a0child\u00a0classes\u00a0will\u00a0need.\u00a0Mainly\u00a0DB\u00a0connectivity\u00a0and
\n
\u00a0\u00a0*\u00a0the\u00a0ability\u00a0to\u00a0log\u00a0errors.
\n
\u00a0\u00a0*
\n
\u00a0\u00a0*\u00a0@author\u00a0Joe\u00a0Stump\u00a0<joe@joestump.net>
\n
\u00a0\u00a0*\/
\n
\u00a0\u00a0<\/span>class\u00a0<\/span>Base\u00a0<\/span>extends\u00a0<\/span>PEAR
\n
\u00a0\u00a0<\/span>{
\n
\u00a0\u00a0\u00a0\u00a0<\/span>\/**
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0DB\u00a0Class
\n
\u00a0\u00a0\u00a0\u00a0*
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@author\u00a0Joe\u00a0Stump\u00a0<joe@joestump.net>
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@access\u00a0public
\n
\u00a0\u00a0\u00a0\u00a0*\/
\n
\u00a0\u00a0\u00a0\u00a0<\/span>var\u00a0<\/span>$db<\/span>;<\/p>\n

\u00a0\u00a0\u00a0\u00a0<\/span>\/**
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0Log\u00a0Class
\n
\u00a0\u00a0\u00a0\u00a0*
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@author\u00a0Joe\u00a0Stump\u00a0<joe@joestump.net>
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@access\u00a0public
\n
\u00a0\u00a0\u00a0\u00a0*\/
\n
\u00a0\u00a0\u00a0\u00a0<\/span>var\u00a0<\/span>$log<\/span>;<\/p>\n

\u00a0\u00a0\u00a0\u00a0<\/span>\/**
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0Base\u00a0Contstructor
\n
\u00a0\u00a0\u00a0\u00a0*
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0Connect\u00a0to\u00a0the\u00a0DB\u00a0and\u00a0create\u00a0our\u00a0Log,\u00a0which\u00a0can\u00a0then\u00a0be
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0used\u00a0by\u00a0all\u00a0children\u00a0classes.
\n
\u00a0\u00a0\u00a0\u00a0*
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@author\u00a0Joe\u00a0Stump\u00a0<joe@joestump.net>\u00a0
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@acces\u00a0public
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@return\u00a0void
\n
\u00a0\u00a0\u00a0\u00a0*\/
\n
\u00a0\u00a0\u00a0\u00a0<\/span>function\u00a0<\/span>Base<\/span>()
\n
\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this<\/span>-><\/span>PEAR<\/span>();<\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0if(<\/span>get_class<\/span>(<\/span>$this<\/span>)\u00a0==\u00a0<\/span>'base'<\/span>)
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this\u00a0<\/span>=\u00a0new\u00a0<\/span>PEAR_Error<\/span>(<\/span>'Base\u00a0is\u00a0an\u00a0abstracted\u00a0class!'<\/span>);
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0else
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this<\/span>-><\/span>db\u00a0<\/span>=&\u00a0<\/span>DB<\/span>::<\/span>connect<\/span>(<\/span>BASE_PEAR_DSN<\/span>,<\/span>true<\/span>);
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0if(<\/span>DB<\/span>::<\/span>isError<\/span>(<\/span>$this<\/span>-><\/span>db<\/span>))
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this\u00a0<\/span>=\u00a0new\u00a0<\/span>PEAR_Error<\/span>(<\/span>$this<\/span>-><\/span>db<\/span>-><\/span>getMessage<\/span>());
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0else
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this<\/span>-><\/span>db<\/span>-><\/span>setFetchMode<\/span>(<\/span>DB_FETCHMODE_ASSOC<\/span>);
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this<\/span>-><\/span>log\u00a0<\/span>=&\u00a0<\/span>Log<\/span>::<\/span>factory<\/span>(<\/span>'syslog'<\/span>,<\/span>'Base'<\/span>);
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}
\n
\u00a0\u00a0\u00a0\u00a0}<\/p>\n

\u00a0\u00a0\u00a0\u00a0<\/span>\/**
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0Base\u00a0Destructor
\n
\u00a0\u00a0\u00a0\u00a0*
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0Just\u00a0add\u00a0a\u00a0'_'\u00a0to\u00a0your\u00a0class's\u00a0name\u00a0and\u00a0voila!\u00a0you\u00a0have\u00a0a\u00a0PEAR
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0controlled\u00a0destructor!
\n
\u00a0\u00a0\u00a0\u00a0*
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@author\u00a0Joe\u00a0Stump\u00a0<joe@joestump.net>
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@access\u00a0public
\n
\u00a0\u00a0\u00a0\u00a0*\u00a0@return\u00a0void
\n
\u00a0\u00a0\u00a0\u00a0*\/
\n
\u00a0\u00a0\u00a0\u00a0<\/span>function\u00a0<\/span>_Base<\/span>()
\n
\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0if(!<\/span>DB<\/span>::<\/span>isError<\/span>(<\/span>$this<\/span>-><\/span>db<\/span>))
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0{
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/span>$this<\/span>-><\/span>db<\/span>-><\/span>disconnect<\/span>();
\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}
\n
\u00a0\u00a0\u00a0\u00a0}
\n
\u00a0\u00a0}<\/p>\n

<\/span>?>
\n
<\/span>
\n<\/span>
\n<\/code><\/font><\/div>\n

\nThere are a few things that you will notice that are quite a bit different from your average PHP class. The first is
\nit’s documented! No, just kidding, we all document our code. Jokes aside you’ll notice that all we really needed
\nto do to make our class a true PEAR class is extend it from PEAR and make sure we had a properly named destructor.<\/div>\n
\nThere is a side note on destructors. When you create an instance of any PEAR based class you MUST<\/b>
\nassign by reference, meaning =& and not just =. If you do not assign by reference then your destructors will
\nNOT<\/b> run!<\/div>\n<\/div>\n

<\/p>\n

\n
\u00ab Previous Page<\/a><\/div>\n
1<\/a> <\/div>\n
| <\/div>\n
2<\/div>\n
| <\/div>\n
3<\/a> <\/div>\n
| <\/div>\n
4<\/a> <\/div>\n
| <\/div>\n
5<\/a> <\/div>\n
| <\/div>\n
6<\/a> <\/div>\n
| <\/div>\n
7<\/a> <\/div>\n
Next Page \u00bb<\/a><\/div>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"

PEAR stands for “PHP Extension and Application Repository” and has been slowly building itself over the last few years. There are classes for<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-1455","post","type-post","status-publish","format-standard","hentry","category-tutorials"],"_links":{"self":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts\/1455","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/comments?post=1455"}],"version-history":[{"count":1,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts\/1455\/revisions"}],"predecessor-version":[{"id":3310,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts\/1455\/revisions\/3310"}],"wp:attachment":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/media?parent=1455"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/categories?post=1455"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/tags?post=1455"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}