PHP Casting Variable as Object type in foreach Loop

Question

Within the following code, $quiz_object->personalities contains an array of Personality objects.

// Loop through each personality that exists for the quiz
foreach($quiz_object->personalities AS $existing_personality)
{

    // Show all of the existing personalities
    echo $existing_personality->GetQuizMakerPersonalityHTML();
}

How do I "cast" (I think that's the right word) my variable $existing_personality within the foreach loop as the object type?

I wish to do this so that when I type $existing_personality->, I get the list of public functions available for that object type.

UPDATE

At the moment, Zend Studio doesn't know I am looping through an array of Personality objects within the loop, it just thinks it's a standard variable. However, it is a type and my code works perfectly well. I just want the IDE hints on my variable within the foreach loop.

Just so that I'm clear, the hints appear for every other object, if I have:

$personality_object = new Personality();

// I get the IDE hints here
echo $personality_object->MyFunction();

But as soon as I start looping in a foreach, Zend has no way of knowing that I'm looping through an array of Objects.

This is how the array of personalities is defined initially within my Personality object:

class Personality
{

    // Array of Personality objects
    public $personalities = array();

}

I get the hints for every other object, but not for ones that I have in foreach loops. — Luke
– Luke, Commented Sep 13, 2012 at 15:48
Yeah, but do you get any errors when you run the code, or is it just your IDE that's being lame? — Jørgen R
– Jørgen R, Commented Sep 13, 2012 at 16:01

Krycke · Accepted Answer · 2017-01-27 07:04:05Z

114

It much depends on the IDE you are using.

In Netbeans and IntelliJ you are able to use @var in a comment:

/* @var $variable ClassName */
$variable->

The IDE will now know that $variable is of the class ClassName and hint after the ->.

You can try it out in your own IDE as well.

You can also create a @return annotation in a getPersonalities() method stating that the return will be a ClassName[], which means an array of ClassName objects:

/**
 * Returns a list of Personality objects
 * @return Personality[]
 */
function getPersonalities() {
    return $this->personalities;
}

this also depends on how your IDE is interpreting this type of hinting.

To use this in foreach loops you can do 1:

/* @var $existing_personality Personality */
foreach( $quiz_object->personalities as $existing_personality ){
}

or 2:

foreach( $quiz_object->getPersonalities() as $existing_personality ){
}

both should enable IDE hinting, if your IDE is kind enough.

As an extra note, if you want to use this inside it's own class, you can use the same signature when declaring a class variable:

class MyClass
{ 

    /** 
    * @var ClassName[] $variable List of ClassName objects. 
    */ 
    var $variable;

}

edited Jan 27, 2017 at 7:04

answered Sep 13, 2012 at 16:10

Krycke

3,2061 gold badge19 silver badges21 bronze badges

Sign up to request clarification or add additional context in comments.

6 Comments

Xanlantos Over a year ago

Would casting be IDE independent?

Krycke Over a year ago

Would be nice if it was, but as php is not strongly typed, this is just a suggestion to the specific IDE. And then it's up to the IDE how they want to interpret the hinting.

Dawid Ohia Over a year ago

Does anyone know how to get the same effect in Visual Studio Code? Above solution works for NetBeans PHP, but I would appreciate the solution for VS Code.

Richard Kiefer Over a year ago

Awesome, thank you so much! Your /** @var... hint has rescued me, because it is also working in PhpStorm :)

Big Guy Over a year ago

The /* @var $variable ClassName */ also works in Eclipse

|

Bowie · Accepted Answer · 2022-12-15 11:23:53Z

14

just thought I'd throw this in there for those using phpStorm.

I found the way to get the IDE to auto-populate the methods for an object was by including a quick if check beforeheand checking that the object exists and that the $var was an instance of said object.

Example:

foreach ($objArray as $obj) {
    if (is_object($obj) && $obj instanceof DataObject) {
        $obj->thisMethodShouldBeAvailableInPHPStormNow();
    }
}

Found this question while searching for a better way, but the above works for me.

Cheers!

edited Dec 15, 2022 at 11:23

Bowie

828 bronze badges

answered Feb 5, 2014 at 1:21

lordvig

1651 silver badge5 bronze badges

1 Comment

Richard Kiefer Over a year ago

Great to know! Also, the approach of /** @var $variableName ClassName */ from another answer works in PhpStorm. Although, it does not do any real type checking, of course :)

Daniel Guerrero · Accepted Answer · 2016-05-13 07:56:16Z

7

I know this post is old but I think this may help someone:

In PhpStorm works this way, maybe in others too.

/**
 * @param ClassName[] $variables
 */
public function loopFunction($variables){
    foreach ($variables as $variable) {
        echo $variable->functionName();
    }
}

answered May 13, 2016 at 7:56

Daniel Guerrero

1941 gold badge3 silver badges8 bronze badges

1 Comment

Richard Kiefer Over a year ago

Amazing! If you have a member variable, you can also document it your way with /** @var ClassName[] */and it is type hinted in all places within your class. And if you make this member available via some getter, the consumer will also get the type-hint even if your getter function's return value was not documented explicitly.

CommaToast · Accepted Answer · 2014-10-16 22:55:16Z

You can always call out to a separate function from within the foreach, and declare the class in the function declaration. This might also have the benefit of letting you reuse this code elsewhere. For example inside the function getPriceFromProduct below, you see how I declare the class of $product to be Product.

Of course I agree it would be nice to not have to do it this way but hey, it works.

class ProductBundle {

  private $products; //buy this
  public function get_products() { return $this->products; }
  public function add_product($product) { $this->products[] = $product; }

  public function get_price() {
        $products = $this->get_products();
        $prices = array();
        foreach($products as $product) {
            $prices[] = $this->getPriceFromProduct($product);
        }
        return array_sum($prices);
    }

    private function getPriceFromProduct(Product $product) {
        $price = $product->get_price();
        return $price;
    }

Herz · Accepted Answer · 2022-08-05 17:47:11Z

3

for VS Code it's the other way around (ClassName first)

/**@var ClassName $variable*/
foreach ($objArray as $variable) 
{...}

answered Aug 5, 2022 at 17:47

Herz

312 bronze badges

Comments

jleeothon · Accepted Answer · 2018-03-19 16:51:40Z

1

If you want actual type declarations in the code as opposed to comments that could be picked up differently depending on the IDE, you can use the array_* functions, for example array_walk.

array_walk($quiz_object->personalities, function (Personality $p) {
    echo $existing_personality->GetQuizMakerPersonalityHTML();
});

answered Mar 19, 2018 at 16:51

jleeothon

3,2166 gold badges25 silver badges37 bronze badges

1 Comment

TonyG Over a year ago

After reading this suggestion, and with the same challenge, I started to work with the array_walk. I found that this technique requires passing in local variables to the function as arguments, as they are in-scope for the function containing the array_walk, but not in_scope of the closure function. As soon as you realize that you need more than a couple variables, this starts to look inelegant. At that point I think one of the other suggestions should be considered, maybe even just reasigning the element var to a new one with casting for the UI, as in: $casted = (class)$element;

Collectives™ on Stack Overflow

PHP Casting Variable as Object type in foreach Loop

6 Answers 6

6 Comments

1 Comment

1 Comment

Comments

Comments

1 Comment

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

6 Answers 6

6 Comments

1 Comment

1 Comment

Comments

Comments

1 Comment

Your Answer

Sign up or log in

Post as a guest

Linked

Related