Download the PHP package laminas-api-tools/api-tools-skeleton without Composer
On this page you can find all versions of the php package laminas-api-tools/api-tools-skeleton. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download laminas-api-tools/api-tools-skeleton
More information about laminas-api-tools/api-tools-skeleton
Files in laminas-api-tools/api-tools-skeleton
Package api-tools-skeleton
Short Description Skeleton Application for Laminas API Tools
License BSD-3-Clause
Homepage https://api-tools.getlaminas.org
Informations about the package api-tools-skeleton
Laminas API Tools Skeleton Application
🇷🇺 Русским гражданам
Мы, участники Laminas, родились и живем в разных странах. У многих из нас есть друзья, родственники и коллеги как в России, так и в Украине. Некоторые из нас родились в России. Некоторые из нас живут в России. У некоторых бабушки и дедушки сражались с фашистами во Второй мировой войне. Здесь никто не поддерживает фашизм.
У одного из нас есть украинская родственница, которая спаслась из дома вместе с сыном. Поезд задержался из-за бомбежки на дороге впереди. У нас есть друзья, которые прячутся в бомбоубежищах. Мы с тревогой ждем весточки от них после воздушных налетов, которые беспорядочно наносят удары и попадают по больницам, школам, детским садам и домам. Мы не берем это из каких-либо СМИ. Мы наблюдаем это напрямую.
Вы доверяете нам достаточно, чтоб использовать наши программы, и мы просим вас довериться нам вновь. Мы нуждаемся в помощи. Выходите и протестуйте против этой бесполезной войны. Остановите кровопролитие. Скажите "Нет войне!"
🇺🇸 To Citizens of Russia
We at Laminas come from all over the world. Many of us have friends, family and colleagues in both Russia and Ukraine. Some of us were born in Russia. Some of us currently live in Russia. Some have grandparents who fought Nazis in World War II. Nobody here supports fascism.
One team member has a Ukrainian relative who fled her home with her son. The train was delayed due to bombing on the road ahead. We have friends who are hiding in bomb shelters. We anxiously follow up on them after the air raids, which indiscriminately fire at hospitals, schools, kindergartens and houses. We're not taking this from any media. These are our actual experiences.
You trust us enough to use our software. We ask that you trust us to say the truth on this. We need your help. Go out and protest this unnecessary war. Stop the bloodshed. Say "stop the war!"
Requirements
Please see the composer.json file.
Installation
Via release tarball
Grab the latest release via the Laminas API Tools website and/or the releases page; each release has distribution tarballs and zipballs available.
Untar it:
(Where {version}
is the version you downloaded.)
Or unzip, if you chose the zipball:
(Where {version}
is the version you downloaded.)
Via Composer (create-project)
You can use the create-project
command from Composer
to create the project in one go (you need to install composer):
Via Git (clone)
First, clone the repository:
At this point, you need to use Composer to install dependencies. Assuming you already have Composer:
All methods
Once you have the basic installation, you need to put it in development mode:
Now, fire it up! Do one of the following:
- Create a vhost in your web server that points the DocumentRoot to the
public/
directory of the project - Fire up the built-in web server in PHP(note: do not use this for production!)
In the latter case, do the following:
You can then visit the site at http://localhost:8080/ - which will bring up a welcome page and the ability to visit the dashboard in order to create and inspect your APIs.
NOTE ABOUT USING APACHE
Apache forbids the character sequences %2F
and %5C
in URI paths. However, the Laminas API Tools Admin
API uses these characters for a number of service endpoints. As such, if you wish to use the
Admin UI and/or Admin API with Apache, you will need to configure your Apache vhost/project to
allow encoded slashes:
This change will need to be made in your server's vhost file (it cannot be added to .htaccess
).
NOTE ABOUT OPCACHE
Disable all opcode caches when running the admin!
The admin cannot and will not run correctly when an opcode cache, such as APC or OpCache, is enabled. Laminas API Tools does not use a database to store configuration; instead, it uses PHP configuration files. Opcode caches will cache these files on first load, leading to inconsistencies as you write to them, and will typically lead to a state where the admin API and code become unusable.
The admin is a development tool, and intended for use a development environment. As such, you should likely disable opcode caching, regardless.
When you are ready to deploy your API to production, however, you can disable development mode, thus disabling the admin interface, and safely run an opcode cache again. Doing so is recommended for production due to the tremendous performance benefits opcode caches provide.
NOTE ABOUT DISPLAY_ERRORS
The display_errors
php.ini
setting is useful in development to understand what warnings,
notices, and error conditions are affecting your application. However, they cause problems for APIs:
APIs are typically a specific serialization format, and error reporting is usually in either plain
text, or, with extensions like XDebug, in HTML. This breaks the response payload, making it unusable
by clients.
For this reason, we recommend disabling display_errors
when using the Laminas API Tools admin interface.
This can be done using the -ddisplay_errors=0
flag when using the built-in PHP web server, or you
can set it in your virtual host or server definition. If you disable it, make sure you have
reasonable error log settings in place. For the built-in PHP web server, errors will be reported in
the console itself; otherwise, ensure you have an error log file specified in your configuration.
display_errors
should never be enabled in production, regardless.
Vagrant
If you prefer to develop with Vagrant, there is a basic vagrant recipe included with this project.
This recipe assumes that you already have Vagrant installed. The virtual machine will try to use localhost:8080 by default, so if you already have a server on this port of your host machine, you need to shut down the conflicting server first, or if you know how, you can reconfigure the ports in Vagrantfile.
Assuming you have Vagrant installed and assuming you have no port conflicts, you can bring up the Vagrant machine
with the standard up
command:
When the machine comes up, you can ssh to it with the standard ssh forward agent:
The web root is inside the shared directory, which is at /var/www
; this is
also the home directory for the vagrant issue, which will be the initial
directory you land in once you connect via SSH.
The image installs composer during provisioning, meaning you can use it to install and update dependencies:
You can also manipulate development mode:
Vagrant and VirtualBox
The vagrant image is based on
bento/ubuntu-16.04
. If you are using VirtualBox as a provider, you will need:
- Vagrant 1.8.5 or later
- VirtualBox 5.0.26 or later
For vagrant documentation, please refer to vagrantup.com
Docker
If you develop or deploy using Docker, we provide configuration for you.
Prepare your development environment using docker compose:
Start the container:
Access Laminas API Tools from http://localhost:8080/
or http://<boot2docker ip>:8080/
if on Windows or Mac.
You may also use the provided Dockerfile
directly if desired.
Once installed, you can use the container to update dependencies:
Or to manipulate development mode:
QA Tools
The skeleton ships with minimal QA tooling by default, including
laminas/laminas-test. We supply basic tests for the shipped
Application\Controller\IndexController
.
We also ship with configuration for phpcs. If you wish to add this QA tool, execute the following:
We provide aliases for each of these tools in the Composer configuration:
All versions of api-tools-skeleton with dependencies
laminas-api-tools/api-tools Version ^1.7
laminas-api-tools/api-tools-content-negotiation Version ^1.8
laminas-api-tools/api-tools-documentation Version ^1.6
laminas-api-tools/api-tools-rest Version ^1.8
laminas/laminas-component-installer Version ^3.1
laminas/laminas-development-mode Version ^3.9