PHPackages                             p3k/micropub - 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. p3k/micropub

ActiveLibrary

p3k/micropub
============

Utilities to help handle Micropub requests when building servers and clients

0.0.3(7y ago)1216.2k↓42.3%3[2 issues](https://github.com/aaronpk/p3k-micropub/issues)Apache-2.0PHPPHP &gt;=5.6.0

Since Feb 3Pushed 3y ago3 watchersCompare

[ Source](https://github.com/aaronpk/p3k-micropub)[ Packagist](https://packagist.org/packages/p3k/micropub)[ RSS](/packages/p3k-micropub/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (4)Used By (0)

p3k\\Micropub
=============

[](#p3kmicropub)

[![Build Status](https://camo.githubusercontent.com/540af8674a5883179277318add4dfeba5bfcdd7b89b844db927e789d1446a059/68747470733a2f2f7472617669732d63692e6f72672f6161726f6e706b2f70336b2d6d6963726f7075622e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/aaronpk/p3k-micropub)

Usage
-----

[](#usage)

### Creating the Request Object

[](#creating-the-request-object)

If you don't know whether the client has sent a form-encoded or JSON request, you can use the method below to automatically detect the type of input and create the request object. You can pass the raw string input into this function, or an array.

```
$input = file_get_contents('php://input');
$request = \p3k\Micropub\Request::create($input);
```

If you are using a framework like Laravel which handles parsing the input already, you can pass an array with the input:

```
$request = \p3k\Micropub\Request::create(Request::all());
```

### Form-Encoded Input

[](#form-encoded-input)

If you know you are handling a form-encoded request, create a new Micropub Request object given form-encoded input:

```
$request = \p3k\Micropub\Request::createFromPostArray($_POST);
```

### JSON Input

[](#json-input)

Create a new Micropub Request object given an array from JSON input:

```
$input = json_decode(file_get_contents('php://input'), true);
$request = \p3k\Micropub\Request::createFromJSONObject($input);
```

(This actually works given either an Object or Array created from the JSON, but internally it uses an array so it's more efficient to decode it to an array at first.)

### Handling Errors

[](#handling-errors)

If the input data could not be interpreted as a Micropub request, the object returned will be an error instead. You can check for this by testing whether the type of object returned is a `\p3k\Micropub\Error`, or you can test the `error` property.

```
$request = \p3k\Micropub\Request::createFromPostArray($_POST);

if($request->error) {
  // Something went wrong. More information is available here:
  // $request->error_property
  // $request->error_description
}

if(get_class($request) == \p3k\Micropub\Error::class) {
  // Another way to test for errors
}
```

### Handling the Request

[](#handling-the-request)

Now that you have a `$request` object corresponding to the Micropub request, you can inspect it to determine how to handle the request. An outline illustrating a basic Micropub workflow is below.

```
switch($request->action) {
  case 'create':

    // The type of Microformats object being created:
    $request->type; // typically this is `h-entry`

    // All the values of the post are available in this array:
    $request->properties;

    /*
      {
        "content": ["This is a plaintext note"]
      }

      {
        "name": ["Hello World"],
        "content": [{"html": "This is an HTML blog post"]
      }
    */

    // Any Micropub actions such as mp-syndicate-to are available in this array:
    foreach($request->commands as $command=>$value) {
      switch($command) {
        case 'mp-syndicate-to':
          // ...
          break;
        // ... etc
      }
    }

    break;
  case 'update':
    // The URL being updated is available here
    $request->url;

    // ... retrieve the post given by that URL

    // Update actions have three parts: replace, add and delete
    // See https://www.w3.org/TR/micropub/#update for more details

    foreach($request->update['replace'] as $key=>$value) {

    }

    foreach($request->update['add'] as $key=>$value) {

    }

    foreach($request->update['delete'] as $key=>$value) {

    }

    break;
  case 'delete':
    // The URL being deleted is available here:
    $request->url;

    // ... you'll want to retrieve that post and delete it

    break;
}
```

### Output as Microformats JSON

[](#output-as-microformats-json)

You can output the Micropub request as a Microformats JSON array.

```
print_r($request->toMf2());
```

License
-------

[](#license)

Copyright 2018 by Aaron Parecki

Available under the Apache 2.0 and MIT licenses.

#### Apache 2.0

[](#apache-20)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

#### MIT

[](#mit)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

###  Health Score

31

—

LowBetter than 70% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.5% 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 ~35 days

Total

3

Last Release

2899d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/385b302aef27e9e72ddfbf65c8b15cfce5946744fe2e541c5b415665fc2351fc?d=identicon)[aaronpk](/maintainers/aaronpk)

---

Top Contributors

[![aaronpk](https://avatars.githubusercontent.com/u/113001?v=4)](https://github.com/aaronpk "aaronpk (19 commits)")[![gRegorLove](https://avatars.githubusercontent.com/u/3393009?v=4)](https://github.com/gRegorLove "gRegorLove (2 commits)")

---

Tags

p3kindiewebmicropub

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/p3k-micropub/health.svg)

```
[![Health](https://phpackages.com/badges/p3k-micropub/health.svg)](https://phpackages.com/packages/p3k-micropub)
```

###  Alternatives

[indieweb/link-rel-parser

Parse rel values from HTTP headers

2134.8k4](/packages/indieweb-link-rel-parser)[indieweb/representative-h-card

1623.9k2](/packages/indieweb-representative-h-card)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
