-
Notifications
You must be signed in to change notification settings - Fork 35
Getting Started
Download 0.6.0-preview and its matching media kit. The release rebuilds the PHP interface with a workspace sidebar, compact server-side lists, posting/correction previews, atomic multi-item allocation and gross-profit presentation. Compiled CSS is included; no Node is needed on the host. The PHP/MeekroDB architecture and central immutable posting model remain.
This remains a development preview. Full visual/accessibility acceptance, field-level validation consistency and nested source-action returns remain unfinished. Mobile refinement and dark mode are deferred. No accounting sign-off, country certification or WCAG certification is claimed. Back up and rehearse restoration before a 0.5 upgrade; migrations 029-031 are applied in order. Use the release's INSTALL.md and UPGRADE.md. Earlier version-specific sections below are historical context.
Start at the PHP Ledger website or open the demonstration.
Download the 0.2.1-preview package. Choose phpledger-0.2.1-preview.zip and its SHA-256 file from the release assets; automatic source archives do not include installed dependencies. Follow the package's INSTALL.md, or UPGRADE.md when upgrading an existing installation. Use synthetic data for evaluation.
This release adds universal account statements, chart management and saved general-journal draft/review/post/reverse workflows. It retains receipts, expenses, owner reports and the sample cash POS. It is a development preview, with the remaining gates described in First package.
Modern source is in www/phpledger; historical code remains only in Git history. Developers can use the development guide. New project-owned code and documentation are AGPL-3.0-or-later licensed; licence scope preserves separate historical, dependency and asset terms.
Each visitor receives a separate fictional business. Synthetic records reset hourly, ending the old sample session. Capacity limits apply to temporary writes. Do not enter real customer records, credentials or business documents.
- Open Reports → Open account ledger, choose an account and inspect opening, debit, credit, running and closing balances. Transactions and Journals also link directly to the ledger; mobile entries keep the running balance visible.
- Create a general-journal draft with synthetic amounts and save it.
- Reopen it, review the lines and balance debits against credits before posting.
- Follow its source and journal into the account statement and trial balance.
- Try a linked reversal with a reason, or explore the sample shop sale.
Accounts are read-only in the public demo; account creation and changes are reserved for authorized owners/accountants in a self-hosted installation. General-journal draft editing, posting and linked reversals are available within the visitor's books. Reset removes temporary work.
| Requirement | Preview environment |
|---|---|
| PHP | PHP 8.2+ (8.3 recommended) |
| PHP extensions | BCMath, PDO, PDO MySQL, mbstring, cURL, OpenSSL, fileinfo and sessions |
| Database | MySQL 8.4 LTS with InnoDB |
| Dependencies | Composer with a pinned lockfile; production dependencies included in the package |
| Development environment | Docker Compose |
| Web root | Only the new application's www/phpledger/public directory |
| Operations | HTTPS, terminal access, private configuration, backups and tested restoration |
Never serve the repository root, and never use historical installation SQL dumps as the new application's migration path. Follow the instructions for the exact package and retain a reconciled backup before an upgrade.
An administrator prepares the server and initial administrator account. An owner or accountant then creates a business and reviews its accounts and opening-position requirements.
Reviewed opening trial-balance/CSV cutover, period administration, bank CSV reconciliation and core CSV exports are included. Company owners can review and enable the optional POS showcase in Modules; ordinary companies default off and explicit new samples enable it. Existing-business setup must not be treated as complete merely because a name and currency were entered. AR/AP, tax, inventory and production POS are planned optional modules; the eight-country tax research catalog does not activate tax rules.
Package scope and remaining gates · Module roadmap · Support enquiries
This combined preview retains company/book permissions, chart management, receipt/expense/general-journal drafts, balanced posting, linked reversals, opening cutover with a reconciled unpaid-document register, period controls, bank CSV reconciliation, reports, running account balances and CSV exports.
Scoped API/MCP reads and existing-user OAuth/Connections join four fictional businesses: service agency, retail shop, seasonal business and distributor. Each includes 74 sources, 2024–2025 history, an open 2026 practice period and three editable drafts. Follow Reporting walkthroughs and Read integrations.
PHP Ledger · Current status · First package · Roadmap · Contact and contribute
This Wiki describes the revival and its development preview. Feature plans are not release or compliance claims.