PHP download

Download the PHP package williamug/versioning without Composer

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

Table of contents
Download williamug/versioning
More information about williamug/versioning
Files in williamug/versioning

Vendor williamug
Package versioning
Short Description A PHP package that helps you display the version of your Laravel or vanilla PHP application by leveraging git version tags
License MIT
Homepage https://github.com/williamug/versioning

Keywords php versioning version control laravel git tags Williamug

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?

Example code of williamug/versioning

Informations about the package versioning

Versioning

A robust PHP package that helps you display your application's version by leveraging Git tags. Features include caching, multiple format options, error handling, and support for both Laravel and vanilla PHP applications.

Works with Laravel and vanilla PHP!

Quick Links:

Vanilla PHP: VANILLA-PHP-USAGE.md - Standalone usage without Laravel

FTP Deployment: FTP-DEPLOYMENT.md - Deploy via FTP without git

Features

Multiple Version Formats: Tag, full, commit hash, or tag with commit
Performance: Built-in caching support to minimize Git command executions
Secure: Proper input sanitization and error handling
Laravel Integration: Seamless integration with Laravel's facade and Blade directives
Vanilla PHP Support: Works standalone without any framework
Configurable: Extensive configuration options
FTP Deployment Support: Works with deployments that don't include git history
Well-tested: Comprehensive test coverage

Requirements

PHP 8.2 or higher
Laravel 10.x, 11.x, or 12.x (for Laravel integration) or vanilla PHP
Git installed on your system
Optional: Laravel Cache for caching (automatically available in Laravel)

Installation

Install the package via Composer:

Laravel Configuration (Optional)

Publish the configuration file:

This creates config/versioning.php where you can customize:

Usage

Vanilla PHP

Option 1: Using the Helper Function (Simplest)

Option 2: Using the Standalone Class (More Features)

See VANILLA-PHP-USAGE.md for complete standalone usage guide.

Laravel

Using the Facade

Using Blade Directives

Using the Helper Function

Configuration Options

Repository Path

Specify where your .git directory is located:

Caching

Enable caching to improve performance:

Fallback Version

Set a default version when Git is unavailable:

You can set this in your .env:

Version Format

Choose default format:

Version Prefix

Control whether to include 'v' prefix:

Error Handling

The package gracefully handles errors:

Returns fallback version if Git is not installed
Returns fallback version if not in a Git repository
Returns fallback version if no tags exist
Catches and handles all exceptions

Testing

Development

Common Use Cases

Display Version in Footer

API Response

Admin Dashboard

Clear Cache After Deployment

Troubleshooting

"dev" is always displayed

Ensure you're in a Git repository
Ensure Git is installed: git --version
Ensure you have tags: git tag
Check your repository path in config

Create a tag if none exist

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

Asaba William
All Contributors

License

The MIT License (MIT). Please see License File for more information.

All versions of versioning with dependencies

PHP Build Version

Package Version

Version v3.1.0 Release 18. Feb 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of versioning from vendor williamug

Requires php Version ^8.2
spatie/laravel-package-tools Version ^1.16
illuminate/contracts Version ^10.0||^11.0||^12.0

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 williamug/versioning contains the following files

Loading the files please wait ...