Download the PHP package g1a/starter without Composer
On this page you can find all versions of the php package g1a/starter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
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 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.
Informations about the package starter
Starter
A starter PHP project with many services and features pre-configured.
Features
The things this project provides or does includes:
| Creates GitHub project | README with customization instructions |
| Optimized composer.json | GitHub contributing and issue templates |
| Commandline tool with phar builder | Data-driven unit test examples |
| Links to Coveralls code coverage setup | Test matrix for PHP 8.0 - 8.1 |
| Links to Packagist setup | PSR-2 checks and PHP linting |
| Phar self:update command | Configuration files |
For more details, see the section Explanation of Features, below.
Usage
To get started, export your GitHub personal access token and then create a new project.
The new project will be owned by the currently-authenticated user. If you would like to create a new project in an organization instead, then set the GITHUB_ORG environment variable.
The new project will work only with php 8.0 and later. If you need to use an earlier version of php (as far back as php 7.1), then instead run:
Once the new project is created, automated scripts will customize it and set up a number of serivces. See the section Description of Features below for more information. Once the scripts have finished running, you may customize your README file and start coding!
Access Token Generation
Generating and exporting a personal access token for the services below is recommended, as doing this will allow the post-create-project scripts to configure and enable these services automatically.
| Export | Token Generation URL |
|---|---|
| exoirt GITHUB_TOKEN='...' | Generate GitHub token |
Manual Service Configuration
If the personal access token for these services is not set up, then the service may be manually configured later. In addition, this project is also configured for use with Packagist, this service only needs to be manually authorized through their web interface to enable them for projects created with this template.
Follow the links in the table below to configure the services you would like to use.
| Feature | Manual Setup URL |
|---|---|
| Collaborative repository | Create GitHub project |
| Package manager | Register with Packagist |
Explanation of Features
GitHub project
After the composer create-project command runs to create your new project from the templates provided, a GitHub project will automatically be created, and your code will automatically be pushed up.
In order for this to work, you must define a GITHUB_TOKEN environment variable as described in the usage section.
README template
Your new project will be set up with the outline for a project README, complete with status badges, ready to be customized. Follow the instructions provided in your new project to complete the customization steps.
GitHub Actions Testing
GitHub actions will automatically run your unit tests every time a commit is pushed up to GitHub.
Packagist code distribution
Packagist is the main repository for Composer projects. The customization instructions for your project includes a link you may follow to register your project in this repository.
Data-driven unit test examples
Your new project comes with a trivial Example class with tests that demonstrate the phpunit @dataProvider feature.
Test matrix for PHP 8.0 - 8.1
The included test suite demonstrates testing on multiple platforms and PHP versions.
PSR-2 checks and PHP linting
In addition to providing unit tests with phpunit, your new project will also automatically contain style checks for PSR-2 coding convnetions, and will lint your code for syntax errors and other problems.
These features may be accessed via composer cs and composer lint commands, respectively. A .editorconfig file is provided pre-configured to maintain PSR-2 coventions in editors that support this feature.
GitHub contributing and issue templates
GitHub has a feature that allows projects to define pull request and issue templates which will be presented to users when a new issue or pull request is opened. Also, a contributing document can be provided to explain project conventions to new users.
Starter versions for all of these files are automatically added to your new project, and may be customized as needed. By default, the .github directory if you prefer.
Commandline tool
Your project will be set up to build a commandline tool, and also includes commands to package it as a phar using the humbug/box project. If your project is a library, you might still wish to include a commandline tool to provide ad-hoc usage to your library functions, either for testing purposes, or perhaps to directly edit any data stores managed by your library. The commandline tool dependencies are declared in the require-dev section, so they will not be pulled in when your project is included as the dependency of some other project.
If you do not want the commandline tool, simply delete the directories src/Cli and tests/ExampleCommandsTest.php, and also remove the phar:* commands in your composer.json file, and the files example and box.json.dist.
Optimized composer.json
The composer.json file included in the project pre-configures a few settings for convenience:
optimize-autoloader: Creates larger autoload files that find classes more quicklysort-packages: Keeps the list of packages in alphabetic orderplatform:php: Ensures that Composer will only select packages that are compatible with the stated minimum PHP version.
Optimized Composer dist releases
Your project's .gitattributes file comes pre-configured to exclude unnecessary files in Composer dist releases.
Configuration files
Your project will automatically read in a configuration file in yaml format that you may use for providing command option default values and storing other user-overridable settings. See consolidation/config for more information.
Contributing
Please read CONTRIBUTING.md for details on the process for submitting pull requests to us.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- This project makes heavy use of configuration techniques and code from Drush, Robo PHP and other Consolidation projects.
- The KnpLabs github-api and guzzle made the API calls done by this project very easy.
