# PIV

**Repository Path**: spf13_vim/PIV

## Basic Information

- **Project Name**: PIV
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-11-24
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PHP Integration for VIM

## Description 
This project contains the most feature complete and up to date PHP Integration for Vim. 
It began as a fork of the largely outdated VIP (formerly PDV), but has morphed into it's own project. 

It is intended to include the best PHP specific plugins, configurations and resources for editing PHP. 
Special care has been taken to include the best, keep them up to date and make sure everything plays well together.

__It doesn't attempt to include the best _programming_ plugins, so you can use the plugins you prefer.__

The bottom of this readme includes a list of many great plugins that work well with PIV. 
If you are looking for an excellent VIM configuration, please checkout [The Ultimate VIM Configuration](http://spf13.com/post/ultimate-vim-config).

## Features

### Updated Syntax
_Updated for PHP 5.3_

The list of PHP constants, functions, and classes was updated to be current with PHP 5.3.
Many new classes were added in the 5.2 and 5.3 branches and the distributed version only covers up
to 5.1.4. 

### Better Fold Support
This plugin can fold PHP functions and/or classes, properties with their PhpDoc, 
without manually adding marker style folds ({{{ and }}})
http://www.vim.org/scripts/script.php?script_id=1623

Can be turned off by setting 
    let g:DisableAutoPHPFolding = 1
in your .vimrc file.

### PHP Doc Gen
Generate phpDocumentor conforming documentation blocks for your PHP code. 

To use place cursor on line with class, function or variable definition and type ,pd (in n mode)

### Better Completion
PHP completion script for use with omniComplete. 
Using Shawn Biddle's excellent [phpcomplete.vim script](http://www.vim.org/scripts/script.php?script_id=3171)

Completion from current file, included files, tags and php builtin:
	* classes (after new), 
	* functions  
	* variables
	* constants 
	* language keywords 

Either use <C-X><C-O> or install [SuperTab](http://www.vim.org/scripts/script.php?script_id=1643) to use.
By default will show a preview of the function call.

Completion is done via context, for example after -> and :: options limited to funcs and vars.

#### Examples
Example class which has a TAGS file generated for it somewhere 
    class SomeClass { 
      private function _private_method() {} // never shows up in completion list 
      public static function staticMethod() {} // only shows up when using completion on SomeClass::<C-X><C-O> 
      public function completeMe() {} // only shows up when using completion on $instance_of_someclass-><C-X><C-O> 
    } 

#### Non-static completion
    $instance = new SomeClass; 
    ... 
    $instance-><C-X><C-O> to display the omnicompletion menu (see :help ins-completion) 
    $instance->completeMe(); // will autoselect completeMe since it's the only public non-static method 

#### Static completion
    SomeClass::<C-X><C-O> to display omnicompletion menu 
    SomeClass::staticMethod(); // once again will autoselect staticMethod since it's the only public static method 

#### Singleton completion
    $instance = SomeClass::getInstance(); 
    $instance-><C-X><C-O> complete just like non-static 

#### Other features
* Correct restriction of static or standard methods based on context ( show only static methods with :: and only standard with ->) 
* Real support for self:: and $this-> with the aforementioned context restriction 
* Constant variable completion (not just define(VARIABLE, 1) but const VARIABLE = 1) 

### Better indenting w/automatic formatting
Custom php indenting file for VIM

### Full (and current [5.3]) PHP Manual
Simply hit K (shift+k) on any function to see full documentation file for that function even offline.

## Recommendations
It isn't my intention to provide php specific functionality when a good general purpose solution exists.

The following plugins are recommended and can be found in my [Ultimate VIM Configuration](http://spf13.com/post/ultimate-vim-config).

 * [Snipmate](http://github.com/msanders/snipmate.vim)
 * [NerdCommenter](http://github.com/scrooloose/nerdcommenter.git)
 * [NerdTree](http://github.com/scrooloose/nerdtree)
 * [SuperTab](http://www.vim.org/scripts/script.php?script_id=1643)
 * [Fugitive](http://github.com/tpope/vim-fugitive.git)
 * [DelimitMate](http://github.com/Raimondi/delimitMate)
 * [Matchit](http://www.vim.org/scripts/script.php?script_id=39)
 * [CheckSyntax](http://www.vim.org/scripts/script.php?script_id=1431)
 * [Surrounding](http://github.com/msanders/vim-files/blob/master/plugin/surrounding.vim)
 * [AutoCloseTag](http://www.vim.org/scripts/script.php?script_id=2591)
 * [AutoTag](http://www.vim.org/scripts/script.php?script_id=1343)
 * [vim-php-namespace](https://github.com/arnaud-lb/vim-php-namespace)