Download the PHP package bloggermohiuddin/updatecore without Composer

Project Status

UpdateCore is currently under active development.

The core update engine is functional and tested. Additional providers, CLI tooling, and a web dashboard are planned for upcoming releases.

API surface may change before v1.0.0. Use in production at your own discretion.

Overview

Keeping self-hosted applications up to date is one of the most overlooked challenges in PHP development. Manual updates are error-prone, risky, and time-consuming. UpdateCore solves this by providing a complete, reusable auto-update engine that integrates into any PHP project — regardless of framework, architecture, or hosting environment.

UpdateCore uses a zip-based architecture. It fetches the latest commit from GitHub, downloads the repository as a zip archive, extracts only the changed files, backs up the originals, replaces them safely, runs any pending migrations, and rolls back automatically if anything fails.

Whether you are building a SaaS platform, a CMS, an admin panel, a CRM, or a REST API service, UpdateCore gives you production-grade update infrastructure in under 20 files.

How It Works

Features

• Zip-Based Updates — Downloads repository as zip, extracts changed files
• GitHub Integration — Direct integration with GitHub API
• Automatic Rollback — If any step fails, the system restores the previous state
• Backup System — Full backup of affected files before any modification
• Database Migrations — Run SQL or PHP migration files as part of the update process
• PHP Migrations — Support for up() and down() methods with auto-rollback
• Security Guards — Admin authentication, CSRF protection, lock tokens
• Maintenance Mode — Automatic maintenance mode during updates
• Structured Logging — Every operation is logged to file and database
• Framework Independent — Pure PHP 8.0+; works with Laravel, CodeIgniter, raw PHP, anything
• PSR-4 Autoloading — Clean namespace structure

Installation

Via Composer

Quick Start

1. Configure

Create config/updatecore.php or use constants:

2. Initialize

3. Check for Updates

4. Install the Update

5. One-Liner

Configuration

Update Flow

Automatic Rollback

If any step fails during the update process, UpdateCore automatically:

1. Restores all files from backup
2. Disables maintenance mode
3. Unlocks the update system
4. Logs the failure

Database Migrations

Place migration files in storage/migrations/:

Migration with Auto-Rollback

If up() throws an exception, down() is called automatically to rollback.

Security

• Admin Authentication — Verify admin identity before updates
• CSRF Protection — Token-based request validation
• Lock Tokens — Prevent concurrent update attempts
• Backup Before Change — Every file backed up before replacement
• Atomic Writes — Temp file → verify → replace (no partial writes)
• Maintenance Mode — Prevents user access during updates
• Excluded Files — Config files never overwritten

Logging

Logs are stored in two places:

File Logs

storage/logs/update_[job_id].log:

Database Logs

system_logs table stores all log entries with context.

Project Structure

Works With Any PHP Project

Versioning

Roadmap

• [ ] GitLab provider
• [ ] Bitbucket provider
• [ ] CLI command-line interface
• [ ] Web dashboard with real-time progress
• [ ] Differential patch updates
• [ ] Webhook notifications
• [ ] Package dependency resolution
• [ ] Cron integration

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

Code Standards

• PHP 8.0+ with strict types
• PSR-4 autoloading
• PSR-12 coding style
• No framework dependencies
• README must match code

License

MIT License. See LICENSE.