Eclipse PDT - code-hints, references and other goodies

You are viewing revision #1 of this wiki article.
This version may not be up to date with the latest version.
You may want to view the differences to the latest version.

next (#2) »

  1. Intro
  2. Howto
  3. Tips

Intro

Since PHP is dynamically typed language, the way IDE may help you is limited.

It will hint you on methods, fields and class constants, but won't know they type of object you receive when iterating over an array.

Eclipse parses phpDoc comments to find out about function parameter and returned value types, for descriptions and so on.

To make best use of it be sure to add phpDocs in you're code:

/**
 * You'll see this when you get a drop-down 
 * with suggestions for completing the word
 * and onHover on class name.
 */
class Foo {

    /**
     * Description of a field.
     * Be sure to add varType below to get you're code-hints.
     * E.g. $aFoo->bar-> + alt+space will give you drop-down
     * with varType's fields, methods and so on. 
     *
     * @var varType Description of the field
     */
    public $bar;
    
    /**
     * Description of baz
     *
     * @param $var varType [$var description]
     * @return Foo
     */
    public function baz( $var ) {
        return new Foo();
    }
}

Yii has great documentation in the source code allowing IDE to help fellow programmer a great deal.

Howto

To get code-hints you basically need to have Yii (or any other framework/library) on you're build path.

There are 2 ways to achieve this:

Yii inside you're project's source

Say you've got yii (framework dir from ditributed archive) at the same dir as your project's protected dir.

Then you basically don't need to do anything - once Eclipse parses the code you've got all the good stuff.

Yii outside project's source

Here you'll need to add yii (or any other framework/library) to you're include path.

  1. Create project
  2. Go to Project > Properties > PHP Include Path
  3. You've got Projects tab, Libraries tab, Order (and Source in PDT 2.0).
  4. Now use your own judgement:
    • whether to create project for yii (maybe you'd like to checkout latest revisions from time to time?)
    • add Yii as a library (e.g., its in your system- or user-wide PHP includes dir)
    • add Yii as a source folder
  5. Once Eclipse parses the code you've got all the good stuff

Tips

  • Might happen code-hints doesn't work. Try to remove yiilite.php - it has all framework's classes inside but without documentation. Maybe Eclipse stops after parsing it.
  • Having yiilite.php will actually give you all classes twice. You might want to remove it for convenience. (Check docs on performance once you're approaching release date!)
  • Holding mouse over smth in the code will give you tooltip with info on that smth if any.
  • F4 will open type-hierarchy (PDT 2.0).
  • There are more, do your research
14 0
6 followers
Viewed: 42 091 times
Version: Unknown (update)
Category: Tutorials
Tags: IDE
Written by: mindeh
Last updated by: Woil
Created on: Feb 18, 2009
Last updated: 13 years ago
Update Article

Revisions

View all history

Related Articles