Skip to content

Interface to Phpactor (an intelligent code-completion and refactoring tool for PHP)

Notifications You must be signed in to change notification settings

emacs-php/phpactor.el

Repository files navigation

phpactor.el - PHP refactoring and introspection

This package is Emacs interface to Phpactor.

NOTICE: This package is in development. Since some functions are running, this is released as an alpha version.

NOTICE: Phpactor is also in development stage.

MELPA: phpactorMELPA stable: phpactor

Instalation

Requirement: You need to have composer globally installed.

Installation with use-package :

(use-package phpactor :ensuret) (use-package company-phpactor :ensuret) (use-package php-mode ;;:hook ((php-mode . (lambda () (set (make-local-variable'company-backends) '(;; list of backends company-phpactor company-files ))))))

After having installed this package, run `phpactor-install-or-update` (this will install a supported version of phpactor inside `.emacs.d/phpactor`).

NOTICE: To ensure the supported version of Phpactor is installed, you might need to run this command again after an upgrade of this package.

Alternatively, you can install Phpactor on your own and configure `phpactor-executable` but please be aware that any change in Phpactor’s rpc protocol can introduce breakages.

Configuration

eldoc integration

(add-hook'php-mode-hook (lambda () (make-local-variable'eldoc-documentation-function) (setq eldoc-documentation-function 'phpactor-hover)))

phpactor itself

See https://phpactor.github.io/phpactor/configuration.html

keybindings

Phpactor.el doesn’t bring any keybindings and it’s up to you to configure them as you wish.

You could for example limit yourself to only one by using transient.el like this

(define-transient-command php-transient-menu () "Php" [["Class" ("cc""Copy" phpactor-copy-class) ("cn""New" phpactor-create-new-class) ("cr""Move" phpactor-move-class) ("ci""Inflect" phpactor-inflect-class) ("n""Namespace" phpactor-fix-namespace)] ["Properties" ("a""Accessor" phpactor-generate-accessors) ("pc""Constructor" phpactor-complete-constructor) ("pm""Add missing props" phpactor-complete-properties) ("C""Extract const" phpactor-extract-constant) ("r""Rename var locally" phpactor-rename-variable-local) ("R""Rename var in file" phpactor-rename-variable-file)] ["Methods" ("i""Implement Contracts" phpactor-implement-contracts) ("m""Generate method" phpactor-generate-method)] ["Navigate" ("x""List refs" phpactor-list-references) ("X""Replace refs" phpactor-replace-references) (".""Goto def" phpactor-goto-definition)] ["Phpactor" ("s""Status" phpactor-status) ("u""Install" phpactor-install-or-update)]])

Troubleshooting

You can run “phpactor-status“ while visiting a project file.

If needed, configure the way the project root is detected via .dir-locals.el

Phpactor Output” buffer might also contain useful informations.

About

Interface to Phpactor (an intelligent code-completion and refactoring tool for PHP)

Resources

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 11