Download the PHP package richdynamix/arc without Composer

On this page you can find all versions of the php package richdynamix/arc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package arc

Arc

Bootstrap your new Laravel projects with a highly configurable, production ready Docker environment. Automated build, test and deploy to Kubernetes using Travis CI

Overview

Arc is a simple Laravel package to add the ultimate Docker environment for the majority of your applications. Built upon the amazing ContinuousPipe Dockerfiles, this package will add the correct Dockerfile, Docker Compose and configurations into your Laravel project.

Additionally - if selected, it can also add a Continuous Integration & Continuous Deployment configuration to work with Travis CI and Kubernetes.

The Docker configuration provides the following:

CI/CD Configuration contains the following:

Requirements

This package is intended for new Laravel 6 projects.

Installation

Require the package in your project

Run the installer

You will be prompted to choose if you want CI/CD configurations.

Once complete the installer will remove Arc as a composer dependency.

Please Note: If you choose to use the CI/CD configurations then there are some local environment variables that are required before you can run the containers

Run the Container

Continuous Integration and Deployment

Required environment variables to be added to your Travis CI repository settings -

Variable Description Expected values Default
$GITHUB_TOKEN Personal Access Token used to access a private repository string/null null
$DOCKER_EMAIL The email address of your Docker account string null
$DOCKER_PASSWORD Docker account password to push and pull your image string null
$DOCKER_REPO The name of your Docker repository to be pushed to string null
$DOCKER_USERNAME The username of your Docker account to push and pull images string null
$K8S_CLUSTER The name of the cluster in your Kubectl configuration string null
$K8S_CLUSTER_API Kubernetes API endpoint URL FQDN string null
$K8S_PASSWORD The password of the Kubernetes user to access the cluster string null
$K8S_USERNAME The username of the Kubernetes user to access the cluster string null

Static Code Analysis

You may use your phpcs.xml and ruleset.xml file to configure your IDE such as PHPStorm to automatically check your code during development

From within the container, you may run any of your static code analysis tools at any time using the following commands:

Additionally, you can run container phpunit to run your test suite within the container.

Connecting to the Web Container

As part of the Arc configurations there is a simple bash script added to the root of your project which allows you to call -

This is simply a wrapper script for convenience. Under the hood it's simply calling docker exec -it web bash

Addtionally, you may swap the web argument for any of the container names i.e. ./ssh database, ./ssh redis

Configuration

Arc is nothing more than a way to automatically copy the correct Docker configuration into your Laravel project. While you may have come across several Laravel based Docker environments, none of them cover the production ready setup that the ContinuousPipe Dockerfile provides.

ContinuousPipe Dockerfile offers an extremely flexible and solid infrastructure setup using a simple system of ConfD for templates and SupervisorD for controlling the start of services. The contents of tools/docker/etc and tools/docker/usr are copied into the container at build time which means that we can influence any environment variable and configuration.

Rather that explain all the functions and environment variables available to Arc, it is easier to point you to the documentation for the parent images:

To manipulate your environment you can add values for any of the environment variables for any of the above. Additionally, there are a few specific to Arc which are all defined in tools/docker/usr/local/share/env/20-arc-env.

Variable Description Expected values Default
START_QUEUE Should the Laravel Queue worker be started. true/false true
RUN_LARAVEL_CRON Should the Laravel Queue worker be started. true/false false
START_HORIZON Should Laravel Horizon worker be started. Do not start START_QUEUE & START_HORIZON at the same time. true/false false
COMPOSER_INSTALL_FLAGS Allow the override of composer flags during installation string '--no-interaction --optimize-autoloader --ignore-platform-reqs'

Credits

This package would not have been possible would it not have been for the amazing work of the ContinuousPipe team. Also, a special thanks to Samuel for the introduction of ContinuousPipe and Kubernetes. His ability to teach Docker concepts has been of great value. A huge thanks to Kieren for his attention to detail and everlasting patience when helping me to understand the ContinuousPipe Dockerfiles and setup.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


All versions of arc with dependencies

PHP Build Version
Package Version
Requires php Version ^7.2|^8.0
illuminate/support Version 6.*|7.*|8.*
illuminate/console Version 6.*|7.*|8.*
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package richdynamix/arc contains the following files

Loading the files please wait ....