You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Hugo Thunnissen 4d9907fedc
ci/woodpecker/push/woodpecker Pipeline failed Details
Strip partially typed attributes from resolvecontext when suggesting attributes
3 months ago
benchmarks Add headers to new .el files + delete compile script 10 months ago
scripts Add headers to new .el files + delete compile script 10 months ago
stubs Generate builtin stubs (+ add script to do so) 10 months ago
test Fix bug in autoloader that caused registration of only one FQN per type 3 months ago
.gitignore Implement stub index for builtin functions and types 10 months ago
.woodpecker.yml Another attempt at fixing CI 1 year ago
COPYING Add license information 3 years ago
Makefile Handle quitting more gracefully in worker and pipeline threads 10 months ago
README.md Update README with install/build instructions 10 months ago
phpinspect-autoload.el Fix bug in autoloader that caused registration of only one FQN per type 3 months ago
phpinspect-bmap.el Remove unnecessary macros + use `let' to set PLACE in iterative macros 10 months ago
phpinspect-buffer.el Implement stub index for builtin functions and types 10 months ago
phpinspect-cache.el Use `phpinspect-message' in stead of `message' 10 months ago
phpinspect-changeset.el Update copyright statements and apply some code style improvements 10 months ago
phpinspect-class-struct.el Implement stub index for builtin functions and types 10 months ago
phpinspect-class.el Use phpinspect--class-name, as index can be unset for live edited classes 10 months ago
phpinspect-completion.el Only attempt to return completion kind when it can be found 3 months ago
phpinspect-edtrack.el Update copyright statements and apply some code style improvements 10 months ago
phpinspect-eldoc.el Implement stub index for builtin functions and types 10 months ago
phpinspect-fs.el Update copyright statements and apply some code style improvements 10 months ago
phpinspect-imports.el Convert names to alist for use as completing-read collection 3 months ago
phpinspect-index.el Handle unsupported annotation styles gracefully 3 months ago
phpinspect-meta.el Remove unnecessary macros + use `let' to set PLACE in iterative macros 10 months ago
phpinspect-parse-context.el Apply overall code quality improvements 10 months ago
phpinspect-parser.el Fix native compilation warnings 10 months ago
phpinspect-pipeline.el Handle quitting more gracefully in worker and pipeline threads 10 months ago
phpinspect-project-struct.el Implement stub index for builtin functions and types 10 months ago
phpinspect-project.el Implement stub index for builtin functions and types 10 months ago
phpinspect-queue.el Remove unnecessary macros + use `let' to set PLACE in iterative macros 10 months ago
phpinspect-resolve.el Implement stub index for builtin functions and types 10 months ago
phpinspect-resolvecontext.el Update copyright statements and apply some code style improvements 10 months ago
phpinspect-serialize.el Implement stub index for builtin functions and types 10 months ago
phpinspect-splayt.el Fix bug in `phpinspect-splayt-find-all-between' that impacted import indexation 3 months ago
phpinspect-suggest.el Strip partially typed attributes from resolvecontext when suggesting attributes 3 months ago
phpinspect-toc.el Update copyright statements and apply some code style improvements 10 months ago
phpinspect-token-predicates.el Update copyright statements and apply some code style improvements 10 months ago
phpinspect-type.el Use `defvar' instead of `defconst' for variables that are actually changed during runtime 10 months ago
phpinspect-util.el Convert names to alist for use as completing-read collection 3 months ago
phpinspect-worker.el Handle quitting more gracefully in worker and pipeline threads 10 months ago
phpinspect.el Add #'phpinspect-fix-imports to mode keymap 10 months ago

README.md

phpinspect.el

PHPInspect is a minor mode that provides code intelligence for PHP in Emacs. At its core is a PHP parser implemented in Emacs Lisp. PHPInspect comes with backends for completion-at-point, company-mode and eldoc. A backend for xref (which provides go-to-definition functionality) is planned to be implemented at a later date. The main documentation of the mode is in the docstring of the mode itself (C-h f phpinspect-mode RET to view, or read it in the source code of phpinspect.el).

Projects and Finding Types

By default, phpinspect will recognize composer projects and read their composer.json files for autoload information which is used to find files in which the types/classes/functions you use in your code are defined. It is also possible to add an "include directory" of files that should always be read and indexed for a certain project. To do this, open a file in a project and run M-x phpinspect-project-add-include-dir. You can also edit the list of include directories via M-x customize-goup RET phpinspect RET.

Example Configuration

If you already have a completion UI setup that is able to use completion-at-point-functions as completion source, you can basically just enable phpinspect-mode and you'll be good to go. An example of a basic mode hook configuration to get the most out of phpinspect is the following:

(defun my-php-personal-hook ()
  ;; Shortcut to add use statements for classes you use.
  (define-key php-mode-map (kbd \"C-c u\") 'phpinspect-fix-imports)

  ;; Shortcuts to quickly search/open files of PHP classes.
  ;; You can make these local to php-mode, but making them global
  ;; like this makes them work in other modes/filetypes as well, which
  ;; can be handy when jumping between templates, config files and PHP code.
  (global-set-key (kbd \"C-c a\") 'phpinspect-find-class-file)
  (global-set-key (kbd \"C-c c\") 'phpinspect-find-own-class-file)

  ;; Enable phpinspect-mode
  (phpinspect-mode))

(add-hook 'php-mode-hook #'my-php-personal-hook)

Example config with company mode setup

;;;###autoload
(defun my-php-personal-hook ()
  ;; It is important to enable `company-mode' before setting
  ;; the variables below.
  (company-mode)
  (setq-local company-minimum-prefix-length 0)
  (setq-local company-tooltip-align-annotations t)
  (setq-local company-idle-delay 0.1)
  (setq-local company-backends '(phpinspect-company-backend))

  ;; Shortcut to add use statements for classes you use.
  (define-key php-mode-map (kbd "C-c u") 'phpinspect-fix-imports)

  ;; Shortcuts to quickly search/open files of PHP classes.
  (global-set-key (kbd "C-c a") 'phpinspect-find-class-file)
  (global-set-key (kbd "C-c c") 'phpinspect-find-own-class-file)

  (phpinspect-mode))

(add-hook 'php-mode-hook #'my-php-personal-hook)

Install from git

git clone https://git.snorba.art/hugo/phpinspect.el ~/projects/phpinspect.el
cd ~/projects/phpinspect.el
make
(add-to-list 'load-path "~/projects/phpinspect.el")
(require 'phpinspect)

Compilation

It is highly recommended to byte- or native compile phpinspect. Aside from the normal performance boost that this brings to most packages, it can reduce phpinspect's parsing time by up to 90%. It especially makes a difference when incrementally parsing edited buffers. For example:

benchmarks/parse-file.el uncompiled on Ryzen 5 3600 (time in seconds):

Incremental parse (warmup):
Elapsed time: 0.168390 (0.019751 in 1 GCs)
Incremental parse:
Elapsed time: 0.143811 (0.000000 in 0 GCs)
Incremental parse (no edits):
Elapsed time: 0.000284 (0.000000 in 0 GCs)
Incremental parse repeat (no edits):
Elapsed time: 0.000241 (0.000000 in 0 GCs)
Incremental parse after buffer edit:
Elapsed time: 0.012449 (0.000000 in 0 GCs)
Incremental parse after 2 more edits:
Elapsed time: 0.015839 (0.000000 in 0 GCs)
Bare (no token reuse) parse (warmup):
Elapsed time: 0.048996 (0.000000 in 0 GCs)
Bare (no token reuse) parse:
Elapsed time: 0.052495 (0.000000 in 0 GCs)

benchmarks/parse-file.el with native compilation on Ryzen 5 3600 (time in seconds):

Incremental parse (warmup):
Elapsed time: 0.023432 (0.000000 in 0 GCs)
Incremental parse:
Elapsed time: 0.018350 (0.000000 in 0 GCs)
Incremental parse (no edits):
Elapsed time: 0.000076 (0.000000 in 0 GCs)
Incremental parse repeat (no edits):
Elapsed time: 0.000058 (0.000000 in 0 GCs)
Incremental parse after buffer edit:
Elapsed time: 0.001212 (0.000000 in 0 GCs)
Incremental parse after 2 more edits:
Elapsed time: 0.001381 (0.000000 in 0 GCs)
Bare (no token reuse) parse (warmup):
Elapsed time: 0.013874 (0.000000 in 0 GCs)
Bare (no token reuse) parse:
Elapsed time: 0.013878 (0.000000 in 0 GCs)

Development

Building

make

Running tests

Tests are implemented using ert. You can run them in batch mode with the following command:

make test

# or:
emacs -L ./ -batch -l ert -l ./test/phpinspect-test.el -f ert-run-tests-batch-and-exit