-
Notifications
You must be signed in to change notification settings - Fork 556
/
Copy pathopenapi.yml
160 lines (152 loc) · 8.01 KB
/
openapi.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
openapi: 3.1.0
info:
title: "PHP Website API"
description: "APIs available for use on the www.php.net website."
version: 2025.4.1
servers:
- url: "https://www.php.net"
description: "The php.net website."
components:
pathItems:
releases:
get:
summary: "Atom feed of php.net news and announcements."
responses:
"200":
description: "Atom feed of php.net news and announcements."
content:
"application/atom+xml":
schema:
readOnly: true
externalDocs:
description: "Standard Atom feed with additional fields in the php: xml namespace."
url: http://php.net/ns/releases
paths:
"/mirror-info.php":
get:
summary: >-
Returns information about the host running php.net.
Historically, this was unique per mirror.
With the move to a CDN model in 2019, there is now only one canonical source, and thus only one relevant configuration.
Refer to https://github.com/php/web-php/blob/master/mirror-info.php for the serialization format of the response.
responses:
"200":
description: "Successful response of host configuration. This API does not error."
content:
"text/plain":
schema:
type: string
readOnly: true
externalDocs:
description: "This pipe delimited string's contents are described in the source code for this file."
url: "https://github.com/php/web-php/blob/master/mirror-info.php"
example: "https://www.php.net/|8.4.5|1743832640|0|0|en|manual-noalias|1|Core,date,libxml,json,SPL,Zend OPcache|php-web4|169.254.12.255"
"/releases/feed.php":
"$ref": "#/components/pathItems/releases"
# Redirects to /releases/feed.php
"/relases.atom":
"$ref": "#/components/pathItems/releases"
"/releases/branches.php":
get:
summary: "Currently active versions of PHP."
responses:
"200":
description: "Actively supported per-branch versions of PHP."
content:
"application/json":
schema:
type: array
items:
type: object
properties:
branch:
description: "Major.Minor branch identifier, e.g. (8.4, 5.6, etc...)"
type: string
latest:
description: "Most recent release on this branch (e.g. 8.4.5, 5.6.40, etc...)"
type: string
state:
description: "Overall release readiness of the branch."
type: string
enum:
- stable
- security
- eol
- future
initial_release:
description: "Date on which first GA release of the branch was announced."
type: string
format: date-time
active_support_end:
description: "Date on which general bugfix support for this branch ends."
type: string
format: date-time
security_support_end:
description: "Date on which all support for this branch ends."
type: string
format: date-time
"/release-candidates.php":
get:
summary: "Currently RC versions of PHP."
parameters:
- in: query
name: format
schema:
type: string
enum: [ "json", "serialize" ]
required: false
description: Output format
- in: query
name: only
schema:
type: string
enum: [ "dev_versions" ]
required: false
description: Include only dev version numbers
responses:
"200":
description: "Actively RC per-branch versions of PHP."
content:
"application/json":
schema:
type: array
items:
type: object
properties:
active:
description: "Whether RC version is active"
type: boolean
release:
type: object
properties:
type:
description: "Unstable release type"
type: string
enum:
- alpha
- beta
- RC
number:
description: "Unstable release number"
type: integer
sha256_gz:
description: "Unstable release gz hash"
type: string
sha256_bz2:
description: "Unstable release bz2 hash"
type: string
sha256_xz:
description: "Unstable release xz hash"
type: string
date:
description: "Date of release"
type: string
baseurl:
description: "Download base URL"
type: string
enabled:
description: "enabled"
type: boolean
dev_version:
description: "dev_version"
type: string