2017 © Pedro Peláez
 

library hub-updater

Simple Github Updater for Web Projects

image

kanti/hub-updater

Simple Github Updater for Web Projects

  • Wednesday, August 16, 2017
  • by Kanti
  • Repository
  • 4 Watchers
  • 9 Stars
  • 232 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 4 Forks
  • 0 Open issues
  • 11 Versions
  • 0 % Grown

The README.md

Packagist Packagist Travis Code Climate Code Climate, (*1)

HubUpdater

Simple Github Updater for Web Projects [PHP], (*2)

is HubUpdater for me? [Checklist]

  • [ ] I have a little product/projekt on github. (~ <=30MB)
  • [ ] it can run PHP and uses composers autoloader
  • [ ] I want my users to update my Product with one click

check for an update [simple]

<?php
require 'vendor/autoload.php';

$updater = new \Kanti\HubUpdater('kanti/test');
$updater->update();

how to provide an update?

  • Go to your Repository on github.com ‣‣
  • click on the releases tab ‣‣
  • click on Draft a new release ‣‣
  • Enter your release details ‣‣
  • click on Publish release ‣‣
  • now you can use HubUpdater to update to the newest version.
  • note: The timestamp of the release is used. NOT the version number!!

install via composer

The recommended way to install hub-updater is through Composer., (*3)

# Install Composer
curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of HubUpdater:, (*4)

composer require kanti/hub-updater 0.5.*

After installing, you need to require Composer's autoloader:, (*5)

<?php
require 'vendor/autoload.php';

settings

$settings = array(
    "settingsKey" => 'value',
);
new \Kanti\HubUpdater($settings);
setting description default
name the name your Repository has must be set
branch the branch you like to watch. master
cache the directory you like to put the cache stuff ./cache/
save the directory you like to put the content of the zip ./
prerelease would you like to download the prereleases? false
cacheFile name of the InformationCacheFile(in cacheDir) downloadInfo.json
holdTime time(seconds) the Cached-Information will be used 43200
versionFile name of the InstalledVersionInformation is safed(in cacheDir) installedVersion.json
zipFile name of the temporary zip file(in cacheDir) tmpZipFile.zip
updateignore name of the updateignore file(in root of project) .updateignore
auth github api auth user:apiKey/password null
exceptions if true, will throw new \Exception on failure false

Check for an update [complete]

<?php
require 'vendor/autoload.php';

$updater = new \Kanti\HubUpdater(array(
    "cacheFile" => "downloadInfo.json",//name of the InformationCacheFile(in cacheDir)
    "holdTime" => 43200,//time(seconds) the Cached-Information will be used

    "versionFile" => "installedVersion.json",//name of the InstalledVersionInformation is safed(in cacheDir)
    "zipFile" => "tmpZipFile.zip",//name of the temporary zip file(in cacheDir)
    "updateignore" => ".updateignore",//name of the updateignore file(in root of project)

    "name" => 'kanti/test',//Repository to watch
    "branch" => 'master',//wich branch to watch
    "cache" => 'cache/',//were to put the caching stuff
    "save" => 'save/',//there to put the downloaded Version[default ./]
    "prerelease" => true,//accept prereleases?

    "exceptions" => true,//if true, will throw new \Exception on failure
));
if ($updater->able()) {
    if (isset($_GET['update'])) {
        $updater->update();
        echo '


updated :), (*6)


';
    } else {
        echo '<a href="?update">Update Me</a>'; //only update if they klick this link
    }
} else {
    echo '


uptodate :), (*7)


';
}

the .updateignore file

syntax:

put a file in one line and it will not be updated. note put the .updateignore in your projects root directory, (*8)

.htaccess
favicon.ico
there/the/config.ini/is.ini

The Versions

16/08 2017

dev-master

9999999-dev

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

 

The Development Requires

by Avatar Kanti

06/06 2017

dev-Kanti-patch-1

dev-Kanti-patch-1

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

 

The Development Requires

by Avatar Kanti

02/08 2016

v0.5.1

0.5.1.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

 

The Development Requires

by Avatar Kanti

31/07 2016

v0.5.0

0.5.0.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

 

The Development Requires

by Avatar Kanti

28/11 2015

v0.4.1

0.4.1.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

The Development Requires

by Avatar Kanti

03/02 2015

v0.4

0.4.0.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

The Development Requires

by Avatar Kanti

27/12 2014

v0.3.1

0.3.1.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

by Avatar Kanti

12/12 2014

v0.3.0

0.3.0.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

by Avatar Kanti

25/11 2014

v0.2-alpha2

0.2.0.0-alpha2

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

by Avatar Kanti

25/11 2014

v0.2-alpha

0.2.0.0-alpha

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

by Avatar Kanti

11/11 2014

0.1

0.1.0.0

Simple Github Updater for Web Projects

  Sources   Download

GPL-2.0

The Requires

  • php >=5.3.0

 

by Avatar Kanti