serenata / serenata
Free and open source server providing code assistance for PHP
Requires
- php: ^7.1
- ext-json: *
- ext-mbstring: *
- ext-pdo_sqlite: *
- ext-tokenizer: *
- composer/package-versions-deprecated: ^1.8
- composer/xdebug-handler: ^1.3
- doctrine/cache: ^1.8
- doctrine/collections: ^1.6
- doctrine/common: ^3.0
- doctrine/dbal: ^2.9
- doctrine/orm: ^2.6
- doctrine/persistence: ^2.0
- evenement/evenement: ^3.0
- jetbrains/phpstorm-stubs: dev-master@dev
- league/html-to-markdown: ^4.8
- nikic/php-parser: ^4.3
- ocramius/package-versions: 1.4.*
- php-ds/php-ds: ^1.2
- phpstan/phpdoc-parser: ^0.4
- psr/container: ^1.0
- react/event-loop: ^1.0
- react/promise: ^2.7
- react/socket: ^1.3
- serenata/common: ^0.3.3
- serenata/name-qualification-utilities: ^0.5
- symfony/config: ^4.4
- symfony/console: ^4.4
- symfony/dependency-injection: ^4.4
- symfony/finder: ^4.4
- symfony/yaml: ^4.4
Requires (Dev)
- brianium/paratest: ^2.2
- pepakriz/phpstan-exception-rules: ^0.10.1
- phpstan/phpstan: ^0.12
- phpstan/phpstan-doctrine: ^0.12
- phpstan/phpstan-php-parser: ^0.12
- phpstan/phpstan-phpunit: ^0.12
- phpstan/phpstan-strict-rules: ^0.12
- phpunit/phpunit: ^7.5
- slevomat/coding-standard: ^6.3
- symfony/process: ^4.4
- symfony/var-dumper: ^4.4
This package is auto-updated.
Last update: 2024-04-14 04:19:18 UTC
README
Serenata
Gratis, libre and open source server providing code assistance for PHP
Serenata is a gratis, libre and open source server that performs static analysis on PHP codebases to provide code assistance, such as autocompletion, linting, code navigation and tooltips. It achieves its goal by speaking the language server protocol over sockets with its clients.
Serenata was previously known as "PHP Integrator".
Please see the wiki as well as the website, which contain more information for users, both developers looking to implement clients as well as programmers using the server via editors and IDEs.
Installation
Stable
PHAR (recommended)
Download the latest stable PHAR for your PHP version from the releases page.
Composer
composer create-project "serenata/serenata" serenata --prefer-dist --no-dev
Unstable
You can find the latest unstable builds as PHAR by downloading the artifacts of the latest pipelines or simply install latest master through Composer or by pulling from Git.
Running
Most users will simply want to run Serenata through their favorite editor or IDE. See the website for a list of available clients and how to install them.
If you are writing a new client, please read the following sections.
PHAR
php -d memory_limit=1024M distribution-8.x.phar --uri=tcp://127.0.0.1:11111
Where x is the PHP version you downloaded the PHAR for.
Composer
php -d memory_limit=1024M <Serenata folder>/bin/console --uri=tcp://127.0.0.1:11111
Command Line Arguments
Port
You can select any port you desire, as long as it is not in use on your system.
Host
127.0.0.1 will run on localhost, which means the server will only be reachable from your local machine. This is usually what you want.
You can use other IP addresses such as 0.0.0.0 to make the server reachable across the network or inside a (e.g. Docker) container. (The usual security lecture applies here, as anyone in the network can then connect to the server and request information about your codebase.)
Performance
Use In Other Projects
If you want to make the server part of your (existing) project and use the classes contained inside it for your own purposes:
composer require "serenata/serenata"
Note that the server was designed primarily as an application and not as a library. However, it is still very much possible to instantiate the classes you need yourself.
You may also be interested in other libraries that are part of the Serenata suite. In the future, more code may be split from the server into proper, separate libraries.
Contributing
As this project is inherently large in scope, there is a lot of potential and a lot of areas to work in, so contributions are most welcome! Take a look at our contribution guide.
