08.07.2007 / Object-oriented PHP :: A guide for fellow ISys junkies

Pages: 1 2 3 4 5 6 7 8

Using a constructor

While PHP doesn’t require a constructor, you can still use one. Here’s an example:

1
2
3
4
5
6
7
8
9
10
11
class MyClass {
  public $woot = "Woot!";
 
  function __construct() {
    $this->sayWoot();
  }
 
  private function sayWoot() {
    echo $this->woot;
  }
}

The function name __construct() that I used for the constructor was not chosen randomly. PHP requires that you name your constructor exactly like that. You may see code with a constructor that just uses the same name as the class (like in Java,) but that is now deprecated and has been replaced by the function name __construct(). That’s two underscores.

So, with our constructor set, we can now instantiate an object and it will automatically spit out Woot!.

1
$myObject = new MyClass();

Notice that the constructor really just calls the sayWoot() function. It could’ve done echo $this->woot; itself, but I just wanted to let you see how to reference another class function. It’s pretty similar to referencing the class variables. Also notice that I declared the sayWoot() function as private, so it can’t be called from outside the class.

Passing arguments

So what if we wanted to pass a variable as an argument into a constructor or function? Let’s check it out:

1
2
3
4
5
6
7
8
9
10
11
12
class MyClass {
 
  function __construct($whatToSay) {
    $this->saySomething($whatToSay);
  }
 
  private function saySomething($whatToSay) {
    echo $whatToSay;
  }
}
 
$myObject = new MyClass("Woot!");

It’s pretty similar to Java, so there’s not a whole lot that’s new. Again, the constructor could’ve echoed $whatToSay itself, but I just wanted to show you a little variety.

Passing by reference vs. value

There are two ways to pass an argument to a function: (1) by reference and (2) by value. Let’s look at a couple examples and then I’ll explain what’s going on.

Passing argument by value:

1
2
3
4
5
6
7
8
9
10
11
12
class ValueChanger {
 
  public function changeTheValue($variableToChange) {
    $variableToChange = 'new value';
  }
 
}
 
$valueChanger = new ValueChanger();
$myVar = 'old value';
$valueChanger->changeTheValue($myVar);
echo $myVar;

Passing argument by reference:

1
2
3
4
5
6
7
8
9
10
11
12
class ValueChanger {
 
  public function changeTheValue(&$variableToChange) {
    $variableToChange = 'new value';
  }
 
}
 
$valueChanger = new ValueChanger();
$myVar = 'old value';
$valueChanger->changeTheValue($myVar);
echo $myVar;

As denoted, the first example passes the argument by value while the second example passes the argument by reference. The difference in code is that the second example has an ampersand (&) right before the $variableToChange argument. That’s it. The difference in output is that the first example (passing by value) outputs ‘old value’ while the second example (passing by reference) outputs ‘new value.’ Why?

In the first example, when the changeTheValue() function gets called, PHP creates a copy of our $myVar variable and passes the new copy to the function; once we’re inside the function we’re no longer dealing with our original $myVar variable. Therefore, when we set $variableToChange (the copy that’s inside the function) to ‘new value,’ it doesn’t affect our $myVar variable (the copy that’s outside the function.) In the end, $myVar goes unchanged and our script outputs ‘old value.’

In the second example, when the changeTheValue() function gets called, PHP passes a reference of our $myVar variable to the function. This means, once inside the function, when we set $variableToChange to a new value, we’re also setting $myVar to that new value simultaneously; $variableToChange is merely a reference to $myVar. Due to the reference, $myVar gets set to ‘new value’ and therefore our script outputs ‘new value.’

Pages: 1 2 3 4 5 6 7 8

Tags: , ,


Comments

08.07.2007 / Michael Jackson said:

Nice site you have here Aaron! There’s just one small point that I think you might be interested in. You mentioned that PHP doesn’t support object overloading, but it actually does. Several special methods can be set up on objects, including __get, __set, and __call. This may not be the same implementation as is found in other languages, but it is overloading. Check it out.

08.08.2007 / Aaron Hardy said:

Hey Michael, thanks for joining the intimate conversation! I guess I should have been more clear on my explanation (which I’ve since changed), but I’ve always thought PHP’s attempt at supporting method overloading is pretty weak sauce–more of a hack then true, native overloading as found in other languages (like you noted.) So when I said there are hacks to support the functionality, I guess I just grouped PHP’s way of overloading in with it.

For those of you who may be interested in the functionality Michael’s talking about, here’s PHP’s documentation on overloading.

In any case, it’d probably be fair to remove overloading from my “not supported” list and actually dedicate a section to explaining how it is (kind of) supported in PHP. Thanks for bringing up the issue! I hope you enjoy the rest of the article!

08.08.2007 / Scott said:

Hi Aaron, you did this tutorial just in time for me! I decided to teach myself PHP and good tutorials on using patterns and OOP in PHP is hard to find. I do want to point out that in Intex DAO’s were not static classes, we used the singleton pattern to instantiate a DAO once and then passed a reference to the DAO around. Though I’ve found tutorials on the web showing ways of implementing the singleton pattern in PHP, I cannot find anyone addressing the issue of how to make sure a object is only created once given that in PHP you cannot use “synchronized” key word to insure that a function isn’t called multiple times at the exact same time.

Also, and more important to me, I would like to understand how to create objects and classes that are instantiated and then used across all sessions. for example, if I create a class that has a static variable called “$counter” that starts and 0 and gets incremented every time a function in the class is called, the first time a page is loaded, the counter will increment to 1, the next time a the page is loaded, the object appears to be destroyed and recreated thus the counter is reset to 0 and will never be incremented past 1. Is it possible to create objects in PHP that can be passed around to all sessions that may be connected to the server?

08.08.2007 / Aaron Hardy said:

Hey Scott!! Thanks for joining…the intimate conversation. I’m glad I could be of service, if only a little. You’ve got some really good questions and I’m glad you posted them here publicly, because I’m not much of an authoritative source when it comes to the PHP core engine. With that in mind, I’ll do my best to provide insight where I can.

First off, I guess I completely forgot that we were using the singleton pattern for our DAOs during INTEX II! In any case, I don’t see much of an advantage to using the singleton pattern over static methods in this case. I’d still choose the static methods over the singleton pattern, but I’d love to hear some rebuttal from someone as to why I shouldn’t.

Okay, onto the stuff you were pondering. I think most of your difficulties in finding what you’re looking for is due to the difference in how PHP runs on the server compared to other frameworks like Java or .NET. With Java, you wrote your code and then you had to manually (by clicking a button, likely) compile it before opening it up in a browser for the first time. Then, you never had to re-compile your code until you had some code change that you wanted to take effect on the website. On the other hand, PHP is different. In the simplest of explanations, a PHP page is re-compiled each time it is called by a user. That’s why you don’t have to hit any compile button in your IDE when you want to check out the new changes you’ve made. There are some exceptions where you can actually compile PHP as a long-term executable or you can cache your pages, but again, my explanation is a simplistic one and I can’t elaborate much on the exceptions.

Also, Java can be very thread-based whereas PHP…not so much. Although there are web server environments that are threaded, PHP’s support is fairly limited. In fact, you’ll find a lot of articles where people say that the PHP development team recommends that you don’t run PHP on Apache 2 in multi-threaded mode, but I have yet to see the original source of that statement.

So, taking the differences into consideration, there is no “synchronized” keyword in PHP because there are no threads to synchronize. The same goes for using objects across all sessions. One of the noted benefits of PHP is that everything in memory is cleaned up after each session. There are no “application variables” (as they’re called in ASP) where you can set up a variable that exists over multiple sessions.

This doesn’t mean there aren’t ways to implement functionality similar to what you’re looking for though. PHP has the session_set_save_handler() method that can help save a user’s session to a database or file. You can read about it here:

session_set_save_handler() documentation

Here’s an implementation without using the session_set_save_handler() function:

Application variables in PHP

And if you’re interested in hacking up some threading in PHP, here’s an example:

Multi-threaded PHP

Needless to say, none of these options are super-duper pretty, but that’s not really PHP’s niche.

Anyone else want to comment? Please, I invite you to join….the intimate conversation.

08.09.2007 / Andrew Hegerhorst said:

Way to go on the tutorial, Aaron. For us php noobs it’s a keeper! I was reading through it and had a question, so I thought I would throw it out. Sadly, this will demonstrate exactly how new to php I am. ;)
Here’s the question:

Do you have any thoughts as to when the require function should be used as opposed to the include function? I have read about it a little, but being new to php I would appreciate any thoughts you may have on the subject.

Again, great job on the tutorial…

08.10.2007 / Fernando Mladineo said:

Hey Aaron,

Just started reading your PHP tutorial and I’m already learning new things. I just wanted to point out that you made reference to sayHello() on page 2 instead of sayWoot(). Keep up the good work!

08.10.2007 / Aaron Hardy said:

Hey Andrew and Fernando! I do appreciate you all joining…the intimate conversation! Let’s see what we can do here…

Andrew, when it comes to the difference between include() and require(), you can’t get much better than what PHP’s documentation has to say about it, so I’ll just copy it in here:

“require() and include() are identical in every way except how they handle failure. They both produce a Warning, but require() results in a Fatal Error. In other words, don’t hesitate to use require() if you want a missing file to halt processing of the page. include() does not behave this way, the script will continue regardless.”

Here’s the reference: Documentation on require()

Another thing to add to that is your server may react to warnings and fatal errors differently than another server, depending on your PHP configuration. If you want to see how it works on your particular server, try this example (make sure test.php does NOT exist):

include(”test.php”);
echo “Am I still processing?”;

Then try this one (again, test.php shouldn’t exist):

include(”test.php”);
echo “Am I still processing?”;
?>

And, although you may have already figured it out, include_once() and require_once() check to see if the file was loaded before. If it was, then it ignores the command and doesn’t load the file again. Personally, out of the four options (include(), include_once(), require(), and require_once()) I always choose require_once(). Hope that helps!

Fernando, thanks for the heads up! I’ve made the corrections. Three of them in fact. After writing the article, I thought I’d be a little more creative than the usual HelloWorld, but apparently I let a few slip through the cracks. Enjoy!

05.24.2008 / Dave said:

Just wanted to tell you that you did a great job in laying out this PHP tutorial.
I’ve picked up quite a handful of good tips by reading it.
just wanted to let you know that somebody out there thought this was quite handy!
later


Leave a Comment

Your email address is required but will not be published.




Comment


Warning: stristr() [function.stristr]: Empty delimiter in /home/.navyblue/aaronius/aaronhardy.com/wp-content/plugins/wassup/wassup.php on line 2093