Skip to content

docs: add PHP 8.2 minimum version requirement and upgrade guidance #1767

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lramosvea wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add PHP 8.2 minimum version requirement and upgrade guidance #1767

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@
[![PHP Version Require](http://poser.pugx.org/microsoft/microsoft-graph/require/php)](https://packagist.org/packages/microsoft/microsoft-graph)

## Install the SDK

### Prerequisites
- PHP 8.2 or later (see [PHP supported versions](https://www.php.net/supported-versions.php))

You can install the PHP SDK with Composer by editing your `composer.json` file:
```jsonc
{
Expand Down
19 changes: 19 additions & 0 deletions UPGRADING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,25 @@
This guide highlights breaking changes, bug fixes and new features introduced during major upgrades.


# Upcoming Breaking Change: Minimum PHP version raised to 8.2

The SDK now requires **PHP 8.2 or later**. Support for PHP 7.4, 8.0, and 8.1 has been removed.

## Why

PHP 7.4 (EOL Nov 2022), PHP 8.0 (EOL Nov 2023), and PHP 8.1 (EOL Dec 2025) no longer receive security updates from the PHP project. Continuing to support them prevented us from updating dependencies that have already dropped these versions, introducing potential security vulnerabilities.

## What to do

- Run `php -v` to check your current PHP version.
- If you are on PHP 7.4, 8.0, or 8.1, upgrade to PHP 8.2 or later before updating the SDK.
- No code changes are required — only the PHP runtime version needs to be updated.

**Supported PHP versions:** 8.2, 8.3, 8.4

See https://www.php.net/supported-versions.php for PHP's official support lifecycle.


# Upgrading to 2.0.0
- [New Features](#new-features)
- [Breaking Changes](#breaking-changes)
Expand Down
Loading