com web/php: Add a draft supported versions page, as suggested on Internals.: images/supported-versions.php include/branches.inc
styles/supported-versions.css supported-versions.php

Commit: f1a3ca46cc851552bcad7ce28f6df9e3993a1452 Author: Adam Harvey <aharvey@php.net> Mon, 27 Oct 2014 13:12:28 -0700 Parents: 06658b4306535fc66190d71c3dcd3de60a0db588 Branches: master Link: http://git.php.net/?p=web/php.git;a=commitdiff;h=f1a3ca46cc851552bcad7ce28f6df9e3993a1452 Log: Add a draft supported versions page, as suggested on Internals. Changed paths: A images/supported-versions..php M include/branches.inc A styles/supported-versions.css A supported-versions.php

diff --git a/images/supported-versions.php b/images/supported-versions.php new file mode 100644 index 0000000..7fadf26 --- /dev/null +++ b/images/supported-versions.php @@ -0,0 +1,150 @@ +<?php +include_once $_SERVER['DOCUMENT_ROOT'] . '/include/prepend.inc'; +include_once $_SERVER['DOCUMENT_ROOT'] . '/include/branches.inc'; + +// Sizing constants. +$margin_left = 80; +$margin_right = 50; +$header_height = 24; +$year_width = 120; +$branch_height = 30; +$footer_height = 24; + +function branches_to_show() { + // Basically: show all 5.3+ branches with EOL dates > min_date(). + $branches = array(); + + // Flatten out the majors. + foreach (get_all_branches() as $major => $major_branches) { + foreach ($major_branches as $branch => $version) { + if (version_compare($branch, '5.3', 'ge') && get_branch_security_eol_date($branch) > min_date()) { + $branches[$branch] = $version; + } + } + } + + ksort($branches); + return $branches; +} + +function min_date() { + $now = new DateTime('January 1'); + return $now->sub(new DateInterval('P3Y')); +} + +function max_date() { + $now = new DateTime('January 1'); + return $now->add(new DateInterval('P5Y')); +} + +function date_horiz_coord(DateTime $date) { + $diff = $date->diff(min_date()); + if (!$diff->invert) { + return $GLOBALS['margin_left']; + } + return $GLOBALS['margin_left'] + ($diff->days / (365.24 / $GLOBALS['year_width'])); +} + +$branches = branches_to_show(); +$i = 0; +foreach ($branches as $branch => $version) { + $branches[$branch]['top'] = $header_height + ($branch_height * $i++); +} + +if (!isset($non_standalone)) { + header('Content-Type: image/svg+xml'); + echo '<?xml version="1.0"?>'; +} + +$years = iterator_to_array(new DatePeriod(min_date(), new DateInterval('P1Y'), max_date())); +$width = $margin_left + $margin_right + ((count($years) - 1) * $year_width); +$height = $header_height + $footer_height + (count($branches) * $branch_height); +?> +<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 <?php echo $width ?> <?php echo $height ?>" width="<?php echo $width ?>" height="<?php echo $height ?>"> + <style type="text/css"> + <![CDATA[ + @import url(/fonts/Fira/fira.css); + + text { + fill: #333; + font-family: "Fira Sans", "Source Sans Pro", Helvetica, Arial, sans-serif; + font-size: <?php echo (2 / 3) * $header_height; ?>px; + } + + .branches rect.security { + fill: #f93; + } + + .branches rect.stable { + fill: #9c9; + } + + .branch-labels text { + alignment-baseline: central; + } + + .today line { + stroke: #f33; + stroke-dasharray: 7,7; + stroke-width: 3px; + } + + .today text { + fill: #f33; + text-anchor: middle; + } + + .years line { + stroke: black; + } + + .years text { + text-anchor: middle; + } + ]]> + </style> + + <!-- Branch labels --> + <g class="branch-labels"> + <?php foreach ($branches as $branch => $version): ?> + <text x="0" y="<?php echo $version['top'] + (0.5 * $branch_height) ?>"> + <?php echo htmlspecialchars($branch) ?> + </text> + <?php endforeach ?> + </g> + + <!-- Branch blocks --> + <g class="branches"> + <?php foreach ($branches as $branch => $version): ?> + <?php + $x_release = date_horiz_coord(get_branch_release_date($branch)); + $x_bug = date_horiz_coord(get_branch_bug_eol_date($branch)); + $x_eol = date_horiz_coord(get_branch_security_eol_date($branch)); + ?> + <rect class="stable" x="<?php echo $x_release ?>" y="<?php echo $version['top'] ?>" width="<?php echo $x_bug - $x_release ?>" height="<?php echo $branch_height ?>" /> + <rect class="security" x="<?php echo $x_bug ?>" y="<?php echo $version['top'] ?>" width="<?php echo $x_eol - $x_bug ?>" height="<?php echo $branch_height ?>" /> + <?php endforeach ?> + </g> + + <!-- Year lines --> + <g class="years"> + <?php foreach ($years as $date): ?> + <line x1="<?php echo date_horiz_coord($date) ?>" y1="<?php echo $header_height ?>" x2="<?php echo date_horiz_coord($date) ?>" y2="<?php echo $header_height + (count($branches) * $branch_height) ?>" /> + <text x="<?php echo date_horiz_coord($date) ?>" y="<?php echo 0.8 * $header_height; ?>"> + <?php echo $date->format('j M Y') ?> + </text> + <?php endforeach ?> + </g> + + <!-- Today --> + <g class="today"> + <?php + $now = new DateTime; + $x = date_horiz_coord($now); + ?> + <line x1="<?php echo $x ?>" y1="<?php echo $header_height ?>" x2="<?php echo $x ?>" y2="<?php echo $header_height + (count($branches) * $branch_height) ?>" /> + <text x="<?php echo $x ?>" y="<?php echo $header_height + (count($branches) * $branch_height) + (0.8 * $footer_height) ?>"> + <?php echo 'Today: '.$now->format('j M Y') ?> + </text> + </g> +</svg> diff --git a/include/branches.inc b/include/branches.inc index 03e47ed..dd5e33d 100644 --- a/include/branches.inc +++ b/include/branches.inc @@ -52,6 +52,39 @@ function version_number_to_branch($version) { } } +function get_all_branches() { + $branches = array(); + + foreach ($GLOBALS['OLDRELEASES'] as $major => $releases) { + foreach ($releases as $version => $release) { + if ($branch = version_number_to_branch($version)) { + if (!isset($branches[$major][$branch]) || version_compare($version, $branches[$major][$branch]['version'], 'gt')) { + $branches[$major][$branch] = $release; + $branches[$major][$branch]['version'] = $version; + } + } + } + } + + foreach ($GLOBALS['RELEASES'] as $major => $releases) { + foreach ($releases as $version => $release) { + if ($branch = version_number_to_branch($version)) { + if (!isset($branches[$major][$branch]) || version_compare($version, $branches[$major][$branch]['version'], 'gt')) { + $branches[$major][$branch] = $release; + $branches[$major][$branch]['version'] = $version; + } + } + } + } + + krsort($branches); + foreach ($branches as $major => &$branch) { + krsort($branch); + } + + return $branches; +} + function get_active_branches() { $branches = array(); @@ -136,3 +169,78 @@ function get_eol_branches($always_include = null) { return $branches; } + +/* $branch is expected to have at least two components: MAJOR.MINOR or + * MAJOR.MINOR.REVISION (the REVISION will be ignored if provided). This will + * return either null (if no release exists on the given branch), or the usual + * version metadata from $RELEASES for a single release. */ +function get_initial_release($branch) { + $branch = version_number_to_branch($branch); + if (!$branch) { + return null; + } + $major = substr($branch, 0, strpos($branch, '.')); + + if (isset($GLOBALS['OLDRELEASES'][$major]["$branch.0"])) { + return $GLOBALS['OLDRELEASES'][$major]["$branch.0"]; + } + + /* If there's only been one release on the branch, it won't be in + * $OLDRELEASES yet, so let's check $RELEASES. */ + if (isset($GLOBALS['RELEASES'][$major]["$branch.0"])) { + return $GLOBALS['RELEASES'][$major]["$branch.0"]; + } + + // Shrug. + return null; +} + +function get_branch_bug_eol_date($branch) { + // Hardcode 5.3. + if (strncmp($branch, '5.3', 3) == 0) { + return new DateTime('2013-07-11'); + } + + $date = get_branch_release_date($branch); + + return $date ? $date->add(new DateInterval('P2Y')) : null; +} + +function get_branch_security_eol_date($branch) { + // Hardcode 5.3. + if (strncmp($branch, '5.3', 3) == 0) { + return new DateTime('2014-08-14'); + } + + $date = get_branch_release_date($branch); + + return $date ? $date->add(new DateInterval('P3Y')) : null; +} + +function get_branch_release_date($branch) { + $initial = get_initial_release($branch); + + return $initial ? new DateTime($initial['date']) : null; +} + +function get_branch_support_state($branch) { + $initial = get_branch_release_date($branch); + $bug = get_branch_bug_eol_date($branch); + $security = get_branch_security_eol_date($branch); + + if ($initial && $bug && $security) { + $now = new DateTime; + + if ($now >= $security) { + return 'eol'; + } elseif ($now >= $bug) { + return 'security'; + } elseif ($now >= $initial) { + return 'stable'; + } else { + return 'future'; + } + } + + return null; +} diff --git a/styles/supported-versions.css b/styles/supported-versions.css new file mode 100644 index 0000000..41f5911 --- /dev/null +++ b/styles/supported-versions.css @@ -0,0 +1,18 @@ +/* Branches page */ + +table.standard tr.eol td:first-child { + background: #f99; +} + +table.standard tr.security td:first-child { + background: #f93; +} + +table.standard tr.stable td:first-child { + background: #9c9; +} + +svg { + max-width: 100%; + height: auto; +} diff --git a/supported-versions.php b/supported-versions.php new file mode 100644 index 0000000..22c8e7c --- /dev/null +++ b/supported-versions.php @@ -0,0 +1,103 @@ +<?php +$_SERVER['BASE_PAGE'] = 'supported-versions.php'; + +include_once $_SERVER['DOCUMENT_ROOT'] . '/include/prepend.inc'; +include_once $_SERVER['DOCUMENT_ROOT'] . '/include/branches.inc'; + +site_header('Supported Versions', array('css' => array('supported-versions.css'))); +?> + +<h1>Supported Versions</h1> + +<p> + Each release branch of PHP is fully supported for two years from its initial + stable release. During this period, bugs and security issues that have been + reported are fixed and are released in regular point releases. +</p> + +<p> + After this two year period of active support, each branch is then supported + for an additional year for critical security issues only. Releases during + this period are made on an as-needed basis: there may be multiple point + releases, or none, depending on the number of reports. +</p> + +<p> + Once the three years of support are completed, the branch reaches its end of + life and is no longer supported. <a href="/eol.php">A table of end of life + branches is available.</a> +</p> + +<h3>Currently Supported Versions</h3> + +<table class="standard"> + <thead> + <tr> + <th>Branch</th> + <th colspan="2">Initial Release</th> + <th colspan="2">Active Support Until</th> + <th colspan="2">Security Support Until</th> + </tr> + </thead> + <tbody> + <?php foreach (get_active_branches() as $major => $releases): ?> + <?php ksort($releases) ?> + <?php foreach ($releases as $branch => $release): ?> + <?php + $state = get_branch_support_state($branch); + $initial = get_branch_release_date($branch); + $until = get_branch_bug_eol_date($branch); + $eol = get_branch_security_eol_date($branch); + ?> + <tr class="<?php echo $state ?>"> + <td> + <a href="/downloads.php#v<?php echo htmlspecialchars($release['version']) ?>"> + <?php echo htmlspecialchars($branch) ?> + </a> + </td> + <td><?php echo htmlspecialchars($initial->format('j M Y')) ?></td> + <td><em><?php echo htmlspecialchars(format_interval($initial, null)) ?></em></td> + <td><?php echo htmlspecialchars($until->format('j M Y')) ?></td> + <td><em><?php echo htmlspecialchars(format_interval($until, null)) ?></em></td> + <td><?php echo htmlspecialchars($eol->format('j M Y')) ?></td> + <td><em><?php echo htmlspecialchars(format_interval($eol, null)) ?></em></td> + </tr> + <?php endforeach ?> + <?php endforeach ?> + </tbody> +</table> + +<p> + Or, visualised as a calendar: +</p> + +<?php +/* Chrome doesn't handle @font-face directives in SVG files included via <img> + * tags (which is odd, since it does handle them when you view the SVG files by + * themselves). Instead, we'll just pull the SVG into the page inline, thereby + * ensuring that we have the same text formatting as the rest of the page. */ + +$non_standalone = true; +include $_SERVER['DOCUMENT_ROOT'] . '/images/supported-versions.php'; +?> + +<h4>Key</h4> + +<table class="standard"> + <tr class="stable"> + <td>Active support</td> + <td> + A release that is being actively supported. Reported bugs and security + issues are fixed and regular point releases are made. + </td> + </tr> + <tr class="security"> + <td>Security fixes only</td> + <td> + A release that is supported for critical security issues only. Releases + are only made on an as-needed basis. + </td> + </tr> +</table> + +<?php site_footer(); ?>