cakephp-netbeans
cakephp-netbeans copied to clipboard
CakePHP support in NetBeans
NetBeans CakePHP Plugin
This plugin provides support for CakePHP.
since 2010/07/16
Environments
- NetBeans 8.1+
- CakePHP 1.3.x
- CakePHP 2.x
About CakePHP 3.x
CakePHP3 support is not provide in this plugin. Please use the following : cakephp3-netbeans
How to enable
CakePHP project is not recognized automatically from NetBeans 8.0. Please check project properties > Framework > CakePHP > enabled
What Works
- badge icon
(displayed on project folder)
- configuration files (add app/config files to important files)
- ignored files (hide app/tmp directory)
- cake commands support [*1]
- go to view, go to action
- smart go to [v0.9.0]
- clear cache action [*1]
- install plugins action (from zip file URL)[*1]
- template files (ctp, helper, component, behavior, shell, task)
- create new CakePHP projects from new project option
- code completion support [v0.6]
- code templates
- format for CakePHP action [v0.6.8]
- go to element file from view file [v0.6.9]
- display and change debug level [v0.6.10]
- display CakePHP version number on status bar
- multiple app directories support [v0.6.14]
- check default action [v0.6.15]
- image and element code completion [v0.6.16]
- support for PHPUnit settings and create test case [v0.6.17]
- code generation [v0.8.1]
- run action action
- suport for .cake file (CakePHP 2.x)
[*1] right-click in project node > CakePHP > (Run Command | Clear Cache | Install Plugins)
Ignore tmp directory
app/tmp is ignored with default. If you would like to avoid this, please, uncheck ignore tmp directory
option.
- Tools > Options > PHP > CakePHP (on create a new project)
- project properties > Frameworks > CakePHP (existing project)
Existing Source
Your NetBeans Project needs to have the following trees.
CakePHP 1.3.x
myproject
├─nbproject
├─app
├─cake
├─plugins
├─vendors
├─...
CakePHP 2.x
myproject
├─nbproject
├─app
├─lib
│ └─Cake
├─plugins
├─vendors
├─...
NewProject (Ctrl + Shift + N) > PHP > PHP Application with Existing Source Please select your cakephp dir(e.g. /home/NetBeansProjects/myproject)
App Directory Path
You can set app directory path from source directory. Project properties > Framework > CakePHP > Custom directory path > app
Use multiple app directories
If you use multiple app directories:
// CakePHP 1
cakephp1.3
├─app
├─app2
├─app3
├─myapp
├─...
├─cake
├─plugins
├─vendors
├─...
// CakePHP 2
cakephp2.x
├─app
├─app2
├─app3
├─mycustom
├─...
├─lib
│ └─Cake
├─plugins
├─vendors
├─...
Use app directory as NetBeans project e.g. app1, app2, myapp, e.t.c.:
myproject(e.g. myapp)
├── nbproject
├── Config
├── Console
├── Controller
├── Lib
├── Locale
├── Model
├── Plugin
├── Test
├── Vendor
├── View
├── index.php
├── tmp
└── webroot
- Project properties > Framework > CakePHP
-
app
: "" (empty or ".") -
CakePHP Root
: "../"
Please notice that Code Completion is not available. You have to add the cakephp core path to include path.
After settings, please close your project and reopen it.
.cake file support
.cake
is configuration file for plugins of editors and IDEs.
If your CakePHP project is not default directory structure, you should use it.
e.g. In case of your app/Model
directory name is app/MyModel
,
you have some Controller
directories (Controller(default), SecondController, ThirdController), e.t.c.
You can create it with Dotcake Plugin .
Supported category
- Controller
- Component
- Model
- Behavior
- View
- Helper
If you want to use it, please set its path to Project properties > Framework > CakePHP > .cake
Clear Cache Action
Delete each files of app/tmp/cache/* directorys.
Install Plugins Action
Settings: Tool > Option > PHP > CakePHP
- Name : Set Plugin name. This name is Folder name.
- Url : Set github zipball url
Note
Url is only zipball url.
Run Action: see [*1]
Plugin version numbers are not necessarily latest. Please try to check and edit them manually.
Create New CakePHP Project
You need to connect the network.
- File > New Project (
Ctrl + Shift + N
) - PHP > PHP Application
- Set the project name
- Run Configuration
- PHP Framework > check CakePHP PHP Web Framework
Select Unzip
or Unzip local file
or Composer
or git command
.
If you select Unzip
, also select CakePHP version.
If you want to unzip the local file, please set the option
(Tools > Options > PHP > CakePHP > New Project > Local file path
)
If you want to create a database.php file, please, check the Create database.php.
Also set the following automatically.
- change permission of app/tmp directory (777)
- change Security.salt and Security.cipherSeed values
create a database, you can immediately start development in a local environment.
Installing with composer
We can set default composer.json
on Options panel. We can use --empty
and app name settings when we create a project.
--empty
is used with bake project
. If app name is empty, app directory is source directory, otherwise it is created under the source directory.
Code Completion
Support for core components and helpers (default). Also support for classes in $uses, $components, $helpers.(also contain the alias)
// e.g.
public $uses('Comment', 'Member', 'User');
// $this->Comm [Ctrl + Space] => $this->Comment [Ctrl + Space]
public $components('Search.Prg', 'Foo');
// $this->P [Ctrl + Space] => $this->Prg-> [Ctrl + Space] => display methods and fields
public $helpers('Session', 'Html' => array('className' => 'MyHtml'));
// $this->Html-> [Ctrl + Space] => display MyHtmlHelper class methods and fields
Image File Completion
$this->Html->image('[Ctrl + Space]');
// popup file and directory names in the webroot/img
$this->Html->image('subdir/[Ctrl + Space]');
// popup file and directory names in the webroot/img/subdir
// ...
$this->Html->image('/mydir/[Ctrl + Space]');
// if you want to use files or directories in the webroot directory,
// please, start with "/"
$this->Html->image('Debug[Ctrl + Space]');
$this->Html->image('DebugKit.[Ctrl + Space]');
// support for Plugin images (CakePHP 2.x)
If target file exists, image will be displayed on document window.
You can run code completion also css and script methods ($this->Html->css(), script()
) like the same as image method.
$this->Html->css('[Ctrl + Space]');
// popup file and directory names in the webroot/css
$this->Html->script('subdir/[Ctrl + Space]');
// popup file and directory names in the webroot/js/subdir
$this->Html->css('/mydir/[Ctrl + Space]');
$this->Html->script('PluginName.[Ctrl + Space]');
Element File Completion
$this->element('[Ctrl + Space]');
// popup file names in the appdir/View/Elements/
$this->element('MyPlugin.[Ctrl + Space]');
// support for Plugin elements (CakePHP 2.x)
Fields Completion
This is available in the following fields. This can also complete the plugin name. Please run code completion again(i.e. [Ctrl + Space]) after "PluginName.".
- $components
- $helpers
- $uses
- $actsAs
// e.g.
public $components = array('[Ctrl + Space]');
public $components = array('DebugKit.[Ctrl + Space]');
Go To View Action
You can move from controller action to view file.
- Right-click at the controller action
- Navigate > Go to view
e.g.
class MainController extends AppController{
// ... something
public function index() {
// Right-click or shortcut here
}
}
If you use shortcut, register with Keymap.
When the view file doesn't exist, create the empty view file automatically if set as follows.
Check Auto create a view file when go to view action is run
at Right-click on project node > property > Framework > CakePHP
If you use the theme, set $theme to controller field.
Code Templates
Available code templates : Tools > Options > Editor > Code Templates > HTML/PHP
e.g.
- cappu ->
App::uses('AppController', 'Controller');
- chtml ->
$this->Html->
This feature is also available with code completion.
Go To Action Action
Similar to Go to view action.
- Right-click on the view file (in editor)
- Navigate > Go to action
Smart Go To [v0.9.0]
You can go to specific files relate to a current file.
e.g. In case of current file is Controller, you can go to existing view, model, component, helper and test.
How To Run
There are three ways.
- Shortcuts
- Editor Toolbar Menu
- Context Menu
Shortcuts
Pattern : [Ctrl + Shift + G] [] (or [Ctrl + J] [])
- [Ctrl + Shift + G] [S] : Smart Go To
- [Ctrl + Shift + G] [M] : Go To Model
- [Ctrl + Shift + G] [V] : Go To View
- [Ctrl + Shift + G] [C] : Go To Controller
- [Ctrl + Shift + G] [B] : Go To Behavior
- [Ctrl + Shift + G] [H] : Go To Helper
- [Ctrl + Shift + G] [P] : Go To Component
- [Ctrl + Shift + G] [T] : Go To Test Case
- [Ctrl + Shift + G] [F] : Go To Fixture
Of course, if you don't like these shortcuts, you are able to change them in Options (KeyMap).
Settings
project properties > Frameworks > CakePHP Please uncheck the following if you would like to go to it soon (without popup) when candidate file is only one.
- Show the popup for one candidate item.
Note
- Core helpers, components and behaviors are not contained in popup items.
- Go To View / Action Action is not changed yet.
- Automatic creation option is not available in this feature.
Format+ Action (Format for CakePHP)
This action run the following.
- Reformat (format settings : Tool > Option > Editor > Format)
- Remove indents of Document Block
- Change line separator to LF(Unix)
Q. Why do you add this action?
A. I add in order to follow the CakePHP Coding Standars
Hyperlink for view element files (v0.6.9)
You can go to the element file from view file.
Search the following element file directories:
- app(app/View/Elements, app/views/elememts)
- core(lib/cake/View/Elements, cake/views/elements)
e.g.
$this->element('sample');
Hold down Ctrl key and click on 'sample'.
If there is sample.ctp in the above directories, open the sample.ctp. Otherwise do nothing.
Display and Change debug level (v0.6.10)
You can change debug level on popup list.
When you choose the CakePHP file node, you would find the cake icon and debug level number at the lower right of the window.
If you change debug level, click the icon. Then the popup is displayed. Please, select the debug level number.
Check Default Action (v0.6.15)
Check default asset names. (e.g. css/cake.generic.css, img/cake.icon.png, ...)
Check whether favicon.ico is changed.
PHPUnit Test settings (PHPUnit Test Init Action)
Support for only CakePHP2.x
Project-right-click > CakePHP > PHPUnit Test Init
Do settings for doing PHPUnit Test with NetBeans.
Create following files:
- nbproject/NetBeansSuite.php
- nbproject/phpunit.bat or phpunit.sh
- app/webroot/bootstrap_phpunit.php
And set PHPUnit settings of Project properties:
- bootstrap
- custome script
If you run this action, you can test using fixture with NetBeans.
bootstrap and NetBeansSuite Sources
https://gist.github.com/2055307 (nojimage)
Code Generation
How To Run
Alt
+ Insert
or Right-click on editor, select Insert Code
.
Generate uses, helpers, components and actsAs fields
Dialog is displayed when you run Insert Code action. Please select what you want to use. And code like followings are inserted.
$helpers = array('Html', ..., 'PluignName.SomeHelper');
$componens = array('Session', ..., 'MyComponent');
$uses = array('Post');
$actsAs = array('Tree', ..., 'PluignName.SomeBehavior');
You have to add settings for each classes by yourself if you need it.
Generate validations
This provides support for only Core validations.(e.g. notEmpty, isUnique, e.t.c) At first, you have to write the following before you run this feature.
public $validate = array(
'fieldName' => array(
// please set caret to here
),
);
Please move caret to place which you want to insert, and run Insert Code action. Then, code like followings will be inserted:
// template
'validationName' => array(
'rule' => 'validationName',
'message' => 'validationNamemessage'
},
// template : has arguments(are not initialized)
'validationName' => array(
'rule' => array('validationName', validationName_arg1, validationName_arg2),
'message' => 'validationNamemessage'
},
Since message is focused, you can change it to your message.
Please push Enter
key after you change it. And you can move to next message.
If you want to move to previous message, please push Shift
+ Tab
.
Please see also https://github.com/junichi11/cakephp-netbeans/issues/12
Run Action Action
You can run the action for controller.
- move the current caret position to within brace of action method.
-
right-click > CakePHP > Run Action
orEditor Toolbar > Cake icon > Run Action
- open the browser
public function index() {
// move the caret here
}
Note
Currently, this is available for the simple situation.
Please also see the following: https://github.com/junichi11/cakephp-netbeans/issues/16
CMS Support
baserCMS3
baserCMS is an open source CMS and powered by CakePHP Framework.
Features
- Setting action for Vagrant
- Pallete
- Run PhpMyAdmin and PhpPgAdmin action
- Copy existing theme action
- New Project Wizard
References
- http://basercms.net/
- https://github.com/basercms/basercms
How To Run
- download NBM file or manually create NBM file
- manually install NBM file
How To Develop
- read this page [1] for the general overview but notice that current sources need to be used, then
- checkout NB sources via Mercurial (preferred, easy updates)[2] or download archive with latest NB sources from NB download site [3]
- Tools > NetBeans Platforms - add new platform "NetBeans IDE Dev" that points to the cloned/downloaded sources
- if not done yet, open this module in NetBeans
- Run
References
Trableshooting
Can't get CakePHP verison numbers in the New Project Wizard
- Please try checking whether your machine is connected to internet
- Your request count via GitHub API may be over the limit. Please try waiting for one hour.
Donation
- https://github.com/sponsors/junichi11
License
Common Development and Distribution License (CDDL) v1.0 and GNU General Public License (GPL) v2