Skip to content

Commit

Permalink
Halt maintenance and explain why
Browse files Browse the repository at this point in the history
  • Loading branch information
jeromegamez committed Aug 23, 2023
1 parent a801d00 commit 8c24d89
Show file tree
Hide file tree
Showing 2 changed files with 50 additions and 40 deletions.
72 changes: 32 additions & 40 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,33 @@
[![codecov](https://codecov.io/gh/kreait/firebase-php/branch/main/graph/badge.svg)](https://codecov.io/gh/kreait/firebase-php)
[![Sponsor](https://img.shields.io/static/v1?logo=GitHub&label=Sponsor&message=%E2%9D%A4&color=ff69b4)](https://github.com/sponsors/jeromegamez)

## The future of the Firebase Admin PHP SDK

Development of this SDK has cost thousands of hours of work and the vast majority
of work has been done by one, mostly unpaid, contributor, [@jeromegamez](https://github.com/jeromegamez).

The number of monthly downloads shows that many corporate/agency users rely heavily
on the SDK; however, very few have contributed, and none have given back and
funded this project.

**Unless funding is found to continue maintaining the SDK, maintenance will be halted.**

This is a call to action for the business users of the SDK to figure out a way to
fund the continued maintenance and development of the SDK, as the one person
on which the whole project leans is done with the current status quo.

If you want to help change the situation, please reach out to
[@jeromegamez](https://github.com/jeromegamez) to discuss,
and/or [become a GitHub Sponsor](https://github.com/sponsors/jeromegamez).

_(This text is based on a similar announcement by [@jrfnl](https://github.com/jrfnl) on
the [WordpressCS 3.0 Release Page](https://make.wordpress.org/core/2023/08/21/wordpresscs-3-0-0-is-now-available/)_)

## Table of Contents

- [Overview](#overview)
- [Installation](#installation)
- [Supported Versions](#supported-versions)
- [Fund this project](#fund-this-project)
- [License](#license)

## Overview
Expand All @@ -40,45 +61,16 @@ composer require "kreait/firebase-php:^7.0"
Earlier versions will receive security fixes as long as their **lowest** PHP requirement receives security fixes. For
example, when a version supports PHP 7.4 and PHP 8.0, security support will end when security support for PHP 7.4 ends.

| Version | Initial Release | Supported PHP Versions | Status |
|---------|-----------------|------------------------|----------------------------------------|
| `7.x` | 20 Dec 2022 | `~8.1.0, ~8.2.0` | Active support |
| `6.x` | 01 Jul 2022 | `^7.4, ^8.0` | End of life |
| `5.x` | 01 Apr 2020 | `^7.2` | End of life |
| `4.x` | 14 Feb 2018 | `^7.0` | End of life |
| `3.x` | 22 Apr 2017 | `^7.0` | End of life |
| `2.x` | 06 Nov 2016 | `^7.0` | End of life |
| `1.x` | 15 Jul 2016 | `^5.5, ^7.0` | End of life |
| `0.x` | 09 Jan 2015 | `>=5.4` | End of life |

See [Support for older versions of the SDK](#support-for-older-versions-of-the-sdk) if you need support for an older version.

## Fund this project

This project has been downloaded millions of times and is used in many commercial projects. Support its development
and keep it sustainable by becoming a [GitHub Sponsor](https://github.com/sponsors/jeromegamez).

If you have feature requests and support questions other than bugfix reports, you can ask them by becoming a
[GitHub Sponsor with an at least $50+ monthly tier](https://github.com/sponsors/jeromegamez?frequency=recurring),
and creating a new issue. Support questions must be discussed publicly, I do not provide free 1:1 support in non-public
channels.

Sponsorships are regarded as appreciation for the time and work I invested into this project, with no strings attached.

Please contact [@jeromegamez](https://github.com/jeromegamez) to discuss alternatives to GitHub sponsorships.

### Support for older versions of the SDK

If you are a [GitHub Sponsor with an at least $100+ monthly tier](https://github.com/sponsors/jeromegamez?frequency=recurring),
**all issues** created by you will be addressed with priority, including issues related to an earlier version.

After making a [one-time $100 sponsorship](https://github.com/sponsors/jeromegamez?frequency=one-time),
**one** issue created by you will be addressed with priority, including issues related to an earlier version.

If an issue or feature request requires changes in an earlier version, implementing them can be done for one-time
sponsorships of $100 per estimated hour.

Please don't create Pull Requests for earlier versions of the SDK, as they will not be accepted.
| Version | Initial Release | Supported PHP Versions | Status |
|---------|-----------------|------------------------|-------------|
| `7.x` | 20 Dec 2022 | `~8.1.0, ~8.2.0` | Halted |
| `6.x` | 01 Jul 2022 | `^7.4, ^8.0` | End of life |
| `5.x` | 01 Apr 2020 | `^7.2` | End of life |
| `4.x` | 14 Feb 2018 | `^7.0` | End of life |
| `3.x` | 22 Apr 2017 | `^7.0` | End of life |
| `2.x` | 06 Nov 2016 | `^7.0` | End of life |
| `1.x` | 15 Jul 2016 | `^5.5, ^7.0` | End of life |
| `0.x` | 09 Jan 2015 | `>=5.4` | End of life |

<table>
<body>
Expand Down
18 changes: 18 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,24 @@ Interact with `Google Firebase <https://firebase.google.com>`_ from your PHP app
:target: https://github.com/sponsors/jeromegamez
:alt: Sponsoring

.. warning::
Development of this SDK has cost thousands of hours of work and the vast majority
of work has been done by one, mostly unpaid, contributor, `@jeromegamez <https://github.com/jeromegamez>`_.

The number of monthly downloads shows that many corporate/agency users rely heavily
on the SDK; however, very few have contributed, and none have given back and
funded this project.

**Unless funding is found to continue maintaining the SDK, maintenance will be halted.**

This is a call to action for the business users of the SDK to figure out a way to
fund the continued maintenance and development of the SDK, as the one person
on which the whole project leans is done with the current status quo.

If you want to help change the situation, please reach out to
`@jeromegamez <https://github.com/jeromegamez>`_ to discuss, and/or
`become a GitHub Sponsor <https://github.com/sponsors/jeromegamez>`_.

.. note::
If you are interested in using the PHP Admin SDK as a client for end-user access
(for example, in a web application), as opposed to admin access from a
Expand Down

0 comments on commit 8c24d89

Please sign in to comment.