PHP download

Download the PHP package esi/simple_counter without Composer

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

Table of contents
Download esi/simple_counter
More information about esi/simple_counter
Files in esi/simple_counter

Vendor esi
Package simple_counter
Short Description A simple web hit counter.
License MIT

Keywords file-based counter flat-file visitor-counter hit-counter

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 esi/simple_counter

Informations about the package simple_counter

Simple Counter - A simple web hit counter.

Simple Counter is a simple PHP counter that counts your website visitors. It has the ability to either show the count as plain text or images; and whether to count only unique hits, or all hits. (IP Based)

Important Note

As of v6.0.0, Simple Counter is no longer licensed under the GNU LGPLv3 license.
v6.0.0 is a complete rewrite of the library, and no GNU LGPLv3 licensed code remains.
v5.0.1 and previous are still licensed under the GNU LGPLv3 license.

With that being said, it is important to read the Upgrading section below if you are coming from an older version.

Acknowledgements

The icons used for the default image set (0-9 'png' images found in counter/images/) are licensed under the CC BY 4.0 DEED license, and were designed by StreamlineHQ.

Upgrading

Pre-v6 -> v6 is not a simple upgrade. Several things have changed in this rewrite, and there are breaking changes.

Please read UPGRADING.md first before attempting an upgrade.

Installation

To install Simple Counter, first install via composer:

There are several options defined by default, however you will likely run into issues if you do not change some of them. More information can be found in Usage below.

Copy the counter directory from vendor/esi/simple_counter to your webroot
- The counter directory contains the logs and images directory.
- You can change the name of either directory if you wish, or skip using the counter directory all together and just move logs and images to your webroot.
- However:
  - The ip file and counter file must remain ips.json and counter.json
  - The images must be named 0-9.
Make sure the ips.json and counter.json files within your logs directory are writable.

Usage

More detailed documentation is a work in progress.

Usage is fairly simple once installed. There is currently one option for the type of counter you wish to use, and that is the FlatfileStorage. A DatabaseStorage is slated for an upcoming release.

Simply add the following code to the page where you want the counter to be shown:

Handling Errors

Simple Counter uses Exceptions for various issues that may arise throughout its process.

Currently, most exceptions fall under \Symfony\Component\OptionsResolver\Exception\InvalidOptionsException.

These exceptions can be thrown if:

You pass an option that is not defined.
A given option's value type does not match the allowed types.
When reading/writing to a file encounters an error, since it is likely due to a file name/location issue.
For invalid directories or files, in terms of logDir, imageDir, countFile, ipFile

About

Requirements

Simple Counter works with PHP 8.2.0 or above.

Submitting bugs and feature requests

Bugs and feature requests are tracked on GitHub

Issues are the quickest way to report a bug. If you find a bug or documentation error, please check the following first:

That there is not an Issue already open concerning the bug
That the issue has not already been addressed (within closed Issues, for example)

Contributing

See CONTRIBUTING.md

Backward Compatibility Promise

See backward-compatibility.md

Author

Eric Sizemore - https://www.secondversion.com

License

Simple Counter v6.0.0 and newer

Licensed under the MIT License. See the LICENSE.md file for details.

Simple Counter v5.0.1 and older

Licensed under the GNU LGPL v3 License. See the <= 5.x LICENSE.md file for details.

All versions of simple_counter with dependencies

PHP Build Version

Package Version

Version v6.0.0 Release 06. May 2024
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of simple_counter from vendor esi

Requires php Version ^8.2 <8.5
ext-json Version *
esi/utility Version ^2.0
symfony/options-resolver Version ^7.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 esi/simple_counter contains the following files

Loading the files please wait ....