First version.

Author: dorantor

README.md

@@ -1,2 +1,29 @@
 # mcounter
-Simple memcache counter.
+Dead simple memcached counter.
+
+NB! There is only abstract classes, because it's meant to be redefined.
+
+```php
+class MyCounter extends \Dorantor\AbstractCounter
+{
+    /**
+     * Method for building cache key based on $item value
+     *
+     * @return string
+     */
+    protected function getKey()
+    {
+        return 'myCounter' . (int) $this->item->id;
+    }
+}
+```
+
+And usage:
+```php
+// $client creation is up to you.
+// Most probably you already created one earlier, so just reuse it here.
+$counter = new MyCounter($user, $client);
+if ($counter->value() < 100) {
+    $counter->inc();
+}
+```

composer.json

@@ -0,0 +1,17 @@
+{
+    "name": "dorantor/mcounter",
+    "description": "Very simple lib for memcached based counters.",
+    "keywords": ["memcached", "counter", "cipher"],
+    "homepage": "https://github.com/dorantor/mcounter/",
+    "type": "library",
+    "license": "MIT",
+    "require": {
+        "php": "^5.6|^7.0",
+        "ext-memcached": "*"
+    },
+    "autoload": {
+        "psr-4" : {
+            "Dorantor\\" : "src"
+        }
+    }
+}

src/AbstractCounter.php

@@ -0,0 +1,82 @@
+<?php
+
+/*
+ * This file is part of the dorantor/mcounter package.
+ */
+
+namespace Dorantor;
+
+abstract class AbstractCounter
+{
+    /**
+     * @var \Memcached
+     */
+    private $client;
+
+    /**
+     * @var \Dorantor\CountableInterface
+     */
+    protected $item;
+
+    /**
+     * AbstractCounter constructor.
+     *
+     * @param mixed $item
+     * @param \Memcached                   $client
+     */
+    public function __construct($item, \Memcached $client)
+    {
+        $this->setClient($client);
+        $this->item = $item;
+    }
+
+    /**
+     * Set memcached client object
+     *
+     * @param \Memcached $client
+     */
+    public function setClient(\Memcached $client)
+    {
+        $this->client = $client;
+    }
+
+    /**
+     * Get current counter value
+     *
+     * @return int
+     */
+    public function value()
+    {
+        return $this->client->get($this->getKey());
+    }
+
+    /**
+     * Increase counter
+     *
+     * @param int $step
+     *
+     * @return int value after increase
+     */
+    public function inc($step = 1)
+    {
+        return $this->client->increment($this->getKey(), $step, $this->getInitialalue());
+    }
+
+    /**
+     * Initial counter value
+     * Could be redefined in descendants
+     *
+     * @return int
+     */
+    protected function getInitialValue()
+    {
+        return 0;
+    }
+
+    /**
+     * Method for building cache key based on $item value
+     *
+     * @return string
+     */
+    abstract protected function getKey();
+}

src/CountableInterface.php

@@ -0,0 +1,6 @@
+<?php
+
+namespace Dorantor;
+
+interface CountableInterface
+{}