ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

PHP Companion

by erichard ST3

A Sublime Text 3 plugin that provides cool stuff for PHP 5.3+ coding session.

Details

Installs

  • Total 98K
  • Win 50K
  • OS X 26K
  • Linux 23K
Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28 Aug 27 Aug 26 Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10
Windows 58 74 88 98 97 99 115 73 97 138 168 121 72 46 60 60 75 77 68 88 88 50 58 79 84 94 63 84 61 66 82 94 82 102 92 44 76 76 83 108 91 106 82 79 110 130
OS X 32 34 52 45 59 51 57 34 40 63 95 73 39 32 31 21 33 27 31 41 36 23 21 39 47 45 30 33 18 25 33 52 35 49 49 20 24 28 47 51 55 65 41 36 86 114
Linux 24 28 32 41 39 49 39 30 36 39 63 49 22 32 31 23 27 31 37 41 34 22 24 30 35 37 17 28 21 28 31 38 40 34 38 35 24 34 36 48 41 33 27 31 41 62

Readme

Source
raw.​githubusercontent.​com

Gitter

Sublime PHP Companion

This Sublime Text 3 Package provides cool stuff for PHP 5.3+ coding session.

Successor of SublimeCTagsPHP

This plugin is the successor of SublimeCTagsPHP. PHP Companion uses the built-in index of Sublime Text 3 instead of CTags.

Warning! PHP Companion does not work on Sublime Text 2 and never will.

Installation

Package control

Just search for PHP Companion in package control and you're ready.

Keybinding

The package no longer provides keybindings. You will have to install your own shortcuts. The Default.sublime-keymap-sample will give you the shortcuts I personally use.

Commands

find_use

Just bring your cursor hover a class name, hit the F5 key (personal shortcut) and that's it.

It will show you the different namespace that match your class, pick up one and you're done.

PHP Companion will sort your uses statement in alphabetical order. This can be configured to sort by line length with the use_sort_length user setting.

expand_fqcn

This command expands the class under the cursor to its FQCN (Fully Qualified Class Name). You have two keys for this command F6 and shift+F6 (personal shortcut) that respectively expand with and without the leading namespace separator \.

import_namespace

Just hit the F4 key (personal shortcut), it will add the namespace definition based on the absolute filename of the current file. I use a simple trick to determine where the namespace begun, actually the namespace will start at the first CamelCased folder.

If a namespace is already declared, the command will shout how crazy you are in the status bar.

Warning: This feature requires a filename so the command won't work in an unsaved buffer.

goto_definition_scope

Hit shift+F12 (personal shortcut) to search for a method definition based on the current scope. It will fallback to the “goto_definition” command if a match was not found.

insert_php_constructor_property

Hit F7 (personal shortcut) to insert both a constructor argument and its according property. The property will be private by default but you can change it with the visibility setting.

implement

Place your cursor on a class, abstract class or an interface name and hit the F3 key (personal shortcut). Matching interfaces or classes will be shown. Select one and then import all or one of the methods from that interface or class.

Settings

Settings can be stored either in your system wide “PHP Companion.sublime-settings” file or in the project settings file. This allows you to set preferences per-project if you need to.

If you're storing settings in a project file, put them in a phpcompanion node like this:

"phpcompanion": {
    "namespace_prefix": "VendorName\Project\Foo\Bar",
    "exclude_dir": [
        "vendor",
        "build"
    ]
}

exclude_dir

List of directories to exclude when searching for the class declaration file. Path is relative to the project directory.

Please note that the filtering is done after the search in the index. So this option has no impact on performance, it's just a convenient way to avoid duplicate namespace declaration in some case.

start_dir_pattern

The pattern used to guess the namespace in the import_namespace command. The default pattern should work for most uses cases but you can change it if your projects are stored in different way.

namespace_prefix

If you have a namespace which is not fully exposed by the file path, you can set a namespace prefix. For example, suppose you have a class in

src/Foo/Bar.php

adding a namespace_prefix of 'Vendor\Project' would result in a resolved namespace declaration of

namespace Vendor\Project\Foo;

use_sort_length

When importing use statements with the find_use command, sort statements by the length of the line.

Licence

All of Sublime PHP Companion is licensed under the MIT license.

Copyright © 2013 Erwan Richard erwann.richard@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.