PHPackages josephscott/marmerine - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Caching](/categories/caching) 4. / 5. josephscott/marmerine ActiveLibrary[Caching](/categories/caching) josephscott/marmerine ===================== An alternate Memcached implementation 0.0.3(3y ago)481[1 issues](https://github.com/josephscott/marmerine/issues)[1 PRs](https://github.com/josephscott/marmerine/pulls)MITPHPPHP >=8.1.0CI passing Since Feb 1Pushed 8mo ago2 watchersCompare [ Source](https://github.com/josephscott/marmerine)[ Packagist](https://packagist.org/packages/josephscott/marmerine)[ RSS](/packages/josephscott-marmerine/feed)WikiDiscussions trunk Synced 1mo ago READMEChangelog (3)Dependencies (3)Versions (4)Used By (0) Marmerine ========= [](#marmerine) This is an alternate Memcached implementation. ``` git clone https://github.com/josephscott/marmerine.git composer install php server.php start ``` Storage Commands ---------------- [](#storage-commands) ### `set` [](#set) - **Supported:** Yes ✅ - **Format:** `set [noreply]\r\n\r\n` - **Success Response:** `STORED\r\n` - **Error Response:** `CLIENT_ERROR [error]\r\nERROR\r\n` **Examples** ``` $ printf "set thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED ``` ``` $ printf "set thing 0 300 3\r\nabc123XYZ\r\n" | nc localhost 11211 CLIENT_ERROR bad data chunk ERROR ``` **Description** This will store the value of the given key, even if it already exists. ### `add` [](#add) - **Supported:** Yes ✅ - **Format:** `add [noreply]\r\n\r\n` - **Success Response:** `STORED\r\n` - **Failure Response:** `NOT_STORED\r\n` - **Error Response:** `CLIENT_ERROR [error]\r\nERROR\r\n` **Examples** ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED ``` ``` $ printf "add thing 0 300 3\r\nabc123XYZ\r\n" | nc localhost 11211 CLIENT_ERROR bad data chunk ERROR ``` ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 NOT_STORED ``` **Description** This will store the value of the given key, only if it does not already exist. ### `replace` [](#replace) - **Supported:** Yes ✅ - **Format:** `replace [noreply]\r\n\r\n` - **Success Response:** `STORED\r\n` - **Error Response:** `NOT_STORED\r\n` **Examples** ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "replace thing 0 300 12\r\nabc-REPLACED\r\n" | nc localhost 11211 STORED $ printf "get thing\r\n" | nc localhost 11211 VALUE thing 0 12 abc-REPLACED END ``` ``` $ printf "replace thing 0 300 3\r\nabc\r\n" | nc localhost 11211 NOT_STORED ``` **Description** This will replace the value of the given key. ### `append` [](#append) - **Supported:** Yes ✅ - **Format:** `append [noreply]\r\n\r\n` - **Success Response:** `STORED\r\n` - **Error Response:** `NOT_STORED\r\n` **Examples** ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "append thing 0 300 6\r\n-AFTER\r\n" | nc localhost 11211 STORED $ printf "get thing\r\n" | nc localhost 11211 VALUE thing 0 9 abc-AFTER END ``` ``` $ printf "append thing 0 300 6\r\n-AFTER\r\n" | nc localhost 11211 NOT_STORED ``` **Description**This will append a string to the value of an existing key. ### `prepend` [](#prepend) - **Supported:** Yes ✅ - **Format:** `prepend [noreply]\r\n\r\n` - **Success Response:** `STORED\r\n` - **Error Response:** `NOT_STORED\r\n` **EXAMPLES** ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "prepend thing 0 300 7\r\nBEFORE-\r\n" | nc localhost 11211 STORED $ printf "get thing\r\n" | nc localhost 11211 VALUE thing 0 10 BEFORE-abc END ``` **Description**This will prepend a string to the value of an existing key. ### `cas` [](#cas) - **Supported:** Yes ✅ - **Format:** `cas [noreply]\r\n\r\n` - **Success Response:** `STORED\r\n` - **Error Resposne:** `NOT_STORED\r\n` **EXAMPLES** ``` $ printf "set thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "gets thing\r\n" | nc localhost 11211 VALUE thing 0 3 1 abc END $ printf "cas thing 0 300 3 1\r\nXYZ\r\n"| nc localhost 11211 STORED ``` **Description** Set a new value for a key if the cas token hasn't changed. ### `touch` [](#touch) - **Supported:** Yes ✅ - **Format:** `touch [noreply]\r\n` - **Success Response:** `TOUCHED\r\n` - **Error Resposne:** `NOT_FOUND\r\n` **Examples** ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "touch thing 1800\r\n" | nc localhost 11211 TOUCHED ``` **Description** Update the expiration time of an existing key. Retrieve Commands ----------------- [](#retrieve-commands) ### `get` [](#get) - **Supported:** Yes ✅ - **Format:** `get [key2 key3 ... keyn]\r\n` - **Found Response:** `VALUE \r\n\r\nEND\r\n` - **Not Found Response:** `END\r\n` **Examples** ``` $ printf "set thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "get thing\r\n" | nc localhost 11211 VALUE thing 0 3 abc END ``` ``` $ printf "get thing\r\n" | nc localhost 11211 END ``` ``` $ printf "set thing1 0 300 4\r\n1abc\r\n" | nc localhost 11211 STORED $ printf "set thing2 0 300 4\r\n2abc\r\n" | nc localhost 11211 STORED $ printf "set thing3 0 300 4\r\n3abc\r\n" | nc localhost 11211 STORED $ printf "get thing thing1 thing2 thing3\r\n" | nc localhost 11211 VALUE thing1 0 4 1abc VALUE thing2 0 4 2abc VALUE thing3 0 4 3abc END ``` **Description** Gets the value for the given key. When the key does not exist, a response with just `END\r\n` is given. When multiple keys are provided, only ones that exist will be returned. ### `gets` [](#gets) - **Supported:** Yes ✅ - **Format:** `get [key2 key3 ... keyn]\r\n` - **Found Response:** `VALUE \r\n\r\nEND\r\n` - **Not Found Response:** `END\r\n` **Examples** ``` $ printf "set thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "gets thing\r\n" | nc localhost 11211 VALUE thing 0 3 1 abc END ``` ``` $ printf "gets thing\r\n" | nc localhost 11211 END ``` **Description** This is the get command with the addition of the cas token in the response. ### `gat` [](#gat) - **Supported:** No ⛔ ### `gats` [](#gats) - **Supported:** No ⛔ Delete Commands --------------- [](#delete-commands) ### `delete` [](#delete) - **Supported:** Yes ✅ - **Format:** `delete [noreply]\r\n` - **Success Response:** `DELETED\r\n` - **Not Found Response:** `NOT_FOUND\r\n` **Examples** ``` $ printf "set thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "delete thing\r\n" | nc localhost 11211 DELETED ``` ``` $ printf "delete thing\r\n" | nc localhost 11211 NOT_FOUND ``` **Description** Delete the given key. If the key does not exist then `NOT_FOUND` is returned. ### `flush_all` [](#flush_all) - **Supported:** Yes ✅ - **Format:** `flush_all [delay] [noreply]\r\n` - **Every Response:** `OK\r\n` **Examples** ``` $ printf "flush_all\r\n" | nc localhost 11211 OK ``` ``` $ printf "flush_all\r\n" | nc localhost 11211 OK $ printf "flush_all\r\n" | nc localhost 11211 OK ``` **Description** Delete all of the stored keys. There is no fail or error condition, it always returns `OK`. Arithmetic Commands ------------------- [](#arithmetic-commands) ### `incr` [](#incr) - **Supported:** Yes ✅ - **Format:** `incr [noreply]\r\n` - **Success Response:** `\r\n` - **Error Response:** `CLIENT_ERROR cannot increment or decrement non-numeric value` **Examples** ``` $ printf "add thing 0 300 1\r\n1\r\n" | nc localhost 11211 STORED $ printf "incr thing 1\r\n" | nc localhost 11211 2 $ printf "incr thing 1\r\n" | nc localhost 11211 3 ``` ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "incr thing 1\r\n" | nc localhost 11211 CLIENT_ERROR cannot increment or decrement non-numeric value ``` **Description** This only works on integer values. ### `decr` [](#decr) - **Supported:** Yes ✅ - **Format:** `decr [noreply]\r\n` - **Success Response:** `\r\n` - **Error Response:** `CLIENT_ERROR cannot increment or decrement non-numeric value` **Examples** ``` $ printf "add thing 0 300 1\r\n9\r\n" | nc localhost 11211 STORED $ printf "decr thing 1\r\n" | nc localhost 11211 8 $ printf "decr thing 1\r\n" | nc localhost 11211 7 ``` ``` $ printf "add thing 0 300 3\r\nabc\r\n" | nc localhost 11211 STORED $ printf "decr thing 1\r\n" | nc localhost 11211 CLIENT_ERROR cannot increment or decrement non-numeric value ``` **Description** This only works on integer values. Miscellaneous Commands ---------------------- [](#miscellaneous-commands) ### `quit` [](#quit) - **Supported:** Yes ✅ - **Format:** `quit\r\n` - **Every Response:** ( None ) **Examples** ``` $ printf "quit\r\n" | nc localhost 11211 ``` **Description** This closes the connection to the server. It does not return anything. ### `version` [](#version) - **Supported:** Yes ✅ - **Format:** `version\r\n` - **Every Response:** `VERSION \r\n` **Examples** ``` $ printf "version\r\n" | nc localhost 11211 VERSION 1.6.12 ``` **Description** Get the version number from the server. ### `verbosity` [](#verbosity) - **Supported:** No ⛔ ### `stats` [](#stats) - **Supported:** Yes ✅ - **Format:** `stats\r\n` - **Every Response:** `STAT \r\nEND\r\n` **Example** ``` $ printf "stats\r\n" | nc localhost 11211 STAT pid 92458 STAT uptime 9 STAT time 1650595977 END ``` **Description** Stats that are currently supported: - pid - uptime - time - total\_connections - curr\_items - cmd\_ - \_hits - \_misses Memcached Resources ------------------- [](#memcached-resources) - [Memcached](https://github.com/memcached/memcached), the original. - [Memcached Protocol.txt](https://github.com/memcached/memcached/blob/master/doc/protocol.txt), general description of the protocols. - [Twemproxy](https://github.com/twitter/twemproxy), a proxy for Memcached and Redis from Twitter. - [Twemproxy Memcached Notes](https://github.com/twitter/twemproxy/blob/master/notes/memcache.md), helpful list of of supported Memcached comands in Twemproxy. - [MySQL Memcached TCP Text Protocol](https://docs.oracle.com/cd/E17952_01/mysql-5.6-en/ha-memcached-interfaces-protocol.html), commands outlined for the MySQL implementation. - [Memcached Cheat Sheet](https://lzone.de/cheat-sheet/memcached), a list of other Memcached resources and examples. - [libmemcached-awesome](https://github.com/awesomized/libmemcached), an updated version of the original [libmemcached](https://libmemcached.org/libMemcached.html). - [memc.rs](https://www.memc.rs/intro), Memcached clone written in Rust, compatible with the binary protocol. - [memtier\_benchmark](https://github.com/RedisLabs/memtier_benchmark), a Memcached ( and Redis ) benchmarking tool. - [Expiration Times](https://www.php.net/manual/en/memcached.expiration.php), good description of how Memcached treats the expiration times. ### Health Score 29 — LowBetter than 60% of packages Maintenance40 Moderate activity, may be stable Popularity10 Limited adoption so far Community11 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 90.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~54 days Total 3 Last Release 1449d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b08b3ac375d3b073a7de49cab22f621e759f0aadf4a5157a5ec36ffb71f52a67?d=identicon)[josephscott](/maintainers/josephscott) --- Top Contributors [![josephscott](https://avatars.githubusercontent.com/u/139972?v=4)](https://github.com/josephscott "josephscott (331 commits)")[![joanhey](https://avatars.githubusercontent.com/u/249085?v=4)](https://github.com/joanhey "joanhey (35 commits)") --- Tags memcachedmemcached-server ### Code Quality TestsPest Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/josephscott-marmerine/health.svg) ``` [![Health](https://phpackages.com/badges/josephscott-marmerine/health.svg)](https://phpackages.com/packages/josephscott-marmerine) ``` ### Alternatives [predis/predis A flexible and feature-complete Redis/Valkey client for PHP. 7.8k305.7M2.4k](/packages/predis-predis)[snc/redis-bundle A Redis bundle for Symfony 1.0k39.4M67](/packages/snc-redis-bundle)[react/cache Async, Promise-based cache interface for ReactPHP 444112.4M40](/packages/react-cache)[wp-media/wp-rocket Performance optimization plugin for WordPress 7431.3M3](/packages/wp-media-wp-rocket)[illuminate/cache The Illuminate Cache package. 12835.6M1.4k](/packages/illuminate-cache)[colinmollenhour/php-redis-session-abstract A Redis-based session handler with optimistic locking 6325.6M14](/packages/colinmollenhour-php-redis-session-abstract) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)