PHPackages                             dreamfactory/package-installer - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. dreamfactory/package-installer

AbandonedComposer-plugin[Utility &amp; Helpers](/categories/utility)

dreamfactory/package-installer
==============================

DreamFactory Services Platform(tm) Package Installer

1.4.13(10y ago)31744[1 PRs](https://github.com/dreamfactorysoftware/package-installer/pulls)1Apache-2.0PHP

Since Jan 13Pushed 2y ago9 watchersCompare

[ Source](https://github.com/dreamfactorysoftware/package-installer)[ Packagist](https://packagist.org/packages/dreamfactory/package-installer)[ Docs](https://www.dreamfactory.com/)[ RSS](/packages/dreamfactory-package-installer/feed)WikiDiscussions master Synced 2d ago

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

DreamFactory Platform Package Installer v1.4.13
-----------------------------------------------

[](#dreamfactory-platform-package-installer-v1413)

[![Latest Stable Version](https://camo.githubusercontent.com/02be07bc3c3e35649b2e3dcd773ff73289a55632fc14b08751bfca437a0bf896/68747470733a2f2f706f7365722e707567782e6f72672f647265616d666163746f72792f7061636b6167652d696e7374616c6c65722f762f737461626c652e737667)](https://packagist.org/packages/dreamfactory/package-installer) [![Total Downloads](https://camo.githubusercontent.com/fbf9936b368930f2f624db97ce97028c530858c543569daecc6225d618a8f543/68747470733a2f2f706f7365722e707567782e6f72672f647265616d666163746f72792f7061636b6167652d696e7374616c6c65722f646f776e6c6f6164732e737667)](https://packagist.org/packages/dreamfactory/package-installer) [![Latest Unstable Version](https://camo.githubusercontent.com/0c8fa61704ff5d0489a34c0eeae23c17e11210c821dad8fefe6a7f40e115db99/68747470733a2f2f706f7365722e707567782e6f72672f647265616d666163746f72792f7061636b6167652d696e7374616c6c65722f762f756e737461626c652e737667)](https://packagist.org/packages/dreamfactory/package-installer) [![License](https://camo.githubusercontent.com/b1355ec5d6f81e50d539e1a42ad40a9f19780230ca184fa2c188f595aca3a54a/68747470733a2f2f706f7365722e707567782e6f72672f647265616d666163746f72792f7061636b6167652d696e7374616c6c65722f6c6963656e73652e737667)](https://packagist.org/packages/dreamfactory/package-installer)

DreamFactory Platform Package Installer (PPI) is a tool for installing applications, libraries and plug-ins on to your [DSP](https://github.com/dreamfactorysoftware/dsp-core).

Packages installed with this tool are safe from system upgrades.

Packaging with Composer
-----------------------

[](#packaging-with-composer)

By default, the PPI leverages the package manager used by the DSP, [Composer](http://getcomposer.org). While this document and the package installer require a `composer.json` file to install your package, DSP packages are not required, or limited, to utilize this packaging method. See \[Packaging Without Composer\]\[\] for more information on alternative packaging.

### What's Composer?

[](#whats-composer)

Composer is a dependency manager tracking local dependencies of your projects and libraries.

See  for more information and documentation.

### Installation and Usage

[](#installation-and-usage)

No installation is required. To have the PPI install your package, you need to set the `composer.json` property [type](http://getcomposer.org/doc/04-schema.md#type) to one of the following types:

- `dreamfactory-application`
- `dreamfactory-library`
- `dreamfactory-plugin`

#### Applications

[](#applications)

Applications are DSP applications that consist of only client-side code. These are installed to your DSP's `/storage/applications` directory.

#### Plugins/Libraries

[](#pluginslibraries)

Plugins, or libraries are DSP extensions that consist of code or code and UI components. These are installed to your DSP's `/storage/plugins` directory.

### Specifying Your Package Details

[](#specifying-your-package-details)

In addition to specifying a package type, the PPI utilizes the "extra" section of your project's configuration file (`composer.json`). In this section you can customize the installation of your DSP package:

```
{
    "extra": {
    	"data":	{
    		"application":	{
				"api-name":                "pbox",
				"name":                    "Portal Sandbox",
				"description":             "A sample application that demonstrates the DSP's portal service.",
				"url":                     "/index.php",
				"is-url-external":         false,
				"import-url":              "https://github.com/dreamfactorysoftware/portal-sandbox/archive/master.zip",
				"is-active":               true,
				"requires-fullscreen":     false,
				"allow-fullscreen-toggle": true,
				"toggle-location":         "top"
		}
		"config":       "config/app.config.php",
		"links":        [
			{
				"target": "src/",
				"link":   "pbox"
			}
		]
	}
    }
}

```

In the above example we are giving our package a pretty name, an `api_name` (which defines the route) and a few other details.

#### Application Properties

[](#application-properties)

NameTypeDescription`api-name`stringThe API name for the app`name`stringThe display name of the app`description`stringThe description of the app`is-active`booleanIf false, app is ignored by DSP`url`stringThe absolute/relative url to this app`is-url-external`booleanIndicates the source of the url`import-url`stringThe url from which this app can be downloaded`storage-service-id`intThe id of the storage service`storage-container`stringThe container on the storage service which stores this app`requires-fullscreen`booleanIf true, full screen mode is default`allow-fullscreen-toggle`booleanIf true, full screen mode toggle is available`toggle-location`stringThe location of the toggle. Defaults to "top"### Packaging Without Composer

[](#packaging-without-composer)

Not possible at this time.

### Contributing

[](#contributing)

All code contributions - including those of people having commit access - must go through a pull request and approved by a core developer before being merged. This is to ensure proper review of all the code.

Fork the project, create a feature branch, and send us a pull request.

If you would like to help take a look at the [list of issues](http://github.com/dreamfactorysoftware/dsp-core/issues).

### Community

[](#community)

- Join our other DSP users on [Google Groups](https://groups.google.com/forum/#!forum/dsp-devs)!
- IRC channels are on irc.freenode.org: #dreamfactory for users and #dreamfactory-dev for development.
- Stack Overflow has a growing collection of [DSP related questions](http://stackoverflow.com/questions/tagged/dreamfactory-dsp).

### License

[](#license)

Composer is licensed under the Apache 2.0 License - see the LICENSE.txt file for details

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 95.9% 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 ~6 days

Recently: every ~58 days

Total

83

Last Release

3989d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a6d25412f9819bf51eaf3cb005d1f1239f2b81081c51018240d132b98e6ad2b8?d=identicon)[dreamfactory](/maintainers/dreamfactory)

---

Top Contributors

[![df-jablan](https://avatars.githubusercontent.com/u/2593959?v=4)](https://github.com/df-jablan "df-jablan (419 commits)")[![lucifurious](https://avatars.githubusercontent.com/u/327512?v=4)](https://github.com/lucifurious "lucifurious (18 commits)")

---

Tags

plugincloudinstallerjetpackdsp

### Embed Badge

![Health badge](/badges/dreamfactory-package-installer/health.svg)

```
[![Health](https://phpackages.com/badges/dreamfactory-package-installer/health.svg)](https://phpackages.com/packages/dreamfactory-package-installer)
```

###  Alternatives

[ergebnis/composer-normalize

Provides a composer plugin for normalizing composer.json.

1.1k37.3M2.1k](/packages/ergebnis-composer-normalize)[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

2994.3M16](/packages/vaimo-composer-patches)[automattic/jetpack-autoloader

Creates a custom autoloader for a plugin or theme.

525.5M69](/packages/automattic-jetpack-autoloader)[craftcms/plugin-installer

Craft CMS Plugin Installer

283.3M4](/packages/craftcms-plugin-installer)[typo3/cms-composer-installers

TYPO3 CMS Installers

6113.7M52](/packages/typo3-cms-composer-installers)[infinum/eightshift-libs

WordPress libs developed by Eightshift team to use in modern WordPress.

63118.9k3](/packages/infinum-eightshift-libs)

PHPackages © 2026

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