xref/web-php/mailing-lists.php

<?php
$_SERVER['BASE_PAGE'] = 'mailing-lists.php';
include_once __DIR__ . '/include/prepend.inc';
include_once __DIR__ . '/include/posttohost.inc';
include_once __DIR__ . '/include/email-validation.inc';

$SIDEBAR_DATA = '
<h3>Would like to unsubscribe yourself?</h3>

<p>
 If you have trouble getting off from any of our mailing lists, or
 would like to unsubscribe from a mailing list not listed here, we
 have more information for you on <a href="/unsub.php">the
 unsubscription page</a>.
</p>

<h3>Other PHP related mailing lists</h3>

<p>
 Find the <a href="http://pear.php.net/support/lists.php">PEAR
 lists</a> and the <a href="http://pecl.php.net/support.php">PECL
 lists</a> on their own pages.
</p>

<a id="local"></a>
<h3>Local Mailing Lists and Newsgroups</h3>

<ul class="toc">
 <li><a href="http://groups.google.com/group/dk.edb.internet.webdesign.serverside.php/topics">Danish Newsgroup</a></li>
 <li><a href="http://groups.google.com/group/fr.comp.lang.php/topics">French Newsgroup</a></li>
 <li><a href="http://lists.phpbar.de/mailman/listinfo">German Mailing List</a></li>
 <li><a href="http://groups.google.com/group/de.comp.lang.php.misc/topics">German Newsgroup</a> (also other topics under de.comp.lang.php)</li>
 <li><a href="http://groups.yahoo.com/group/php_greek/">Greek Mailing List</a></li>
 <li><a href="http://weblabor.hu/levlistak">Hungarian Mailing List</a></li>
 <li><a href="http://www.domeus.it/circles/php">Italian Mailing List (at PHPItalia)</a></li>
 <li><a href="http://ml.php.gr.jp/">The Japanese PHP User Group\'s Mailing lists</a></li>
 <li><a href="http://br.groups.yahoo.com/group/php-pt/">Portuguese Mailing List</a></li>
</ul>
';

site_header("Mailing Lists", ["current" => "help"]);

// Some mailing list is selected for [un]subscription
if (isset($_POST['action'])) {

    // No error found yet
    $error = "";

    // Check email address
    if (empty($_POST['email']) || $_POST['email'] == 'user@example.com' ||
        $_POST['email'] == 'fake@from.net' || !is_emailable_address($_POST['email'])) {
        $error = "You forgot to specify an email address to be added to the list, or specified an invalid address." .
                 "<br>Please go back and try again.";
    }

    // Check if any mailing list was selected
    elseif (empty($_POST['maillist'])) {
        $error = "You need to select at least one mailing list to subscribe to." .
                 "<br>Please go back and try again.";
    }

    // Seems to be a valid email address
    else {

        // Decide on request mode, email address part and IP address
        $request = strtolower($_POST['action']);
        if ($request != "subscribe" && $request != "unsubscribe") {
            $request = "subscribe";
        }
        $remote_addr = i2c_realip();

        // Get in contact with main server to [un]subscribe the user
        $result = posttohost(
            "https://main.php.net/entry/subscribe.php",
            [
                "request" => $request,
                "email" => $_POST['email'],
                "maillist" => $_POST['maillist'],
                "remoteip" => $remote_addr,
                "referer" => $MYSITE . "mailing-lists.php",
            ],
        );

        // Provide error if unable to [un]subscribe
        if ($result) {
            $error = "We were unable to subscribe you due to some technical problems.<br>" .
                     "Please try again later.";
        }
    }

    // Give error information or success report
    if (!empty($error)) {
        echo "<p class=\"formerror\">$error</p>";
    } else {
?>
<p>
 A request has been entered into the mailing list processing queue. You
 should receive an email at <?php echo clean($_POST['email']); ?> shortly describing
 how to complete your request.
</p>
<?php
    }
    site_footer();
    exit;
}

// No form submitted
?>
<h1>Mailing Lists</h1>

<p>
 There are many PHP-related mailing lists available on our server.
 Most of them are archived, and all of them are available as newsgroups
 on our <a href="news://news.php.net">news server</a>. You can search
 some mailing lists right from this website from <a href="/search.php">the
 search page</a> or by using the search input box selecting the
 appropriate option on the top-right of every page.
</p>
<p>
 There is an experimental web interface for the news server at
 <a href="http://news.php.net/">http://news.php.net/</a>, and
 there are also other archives provided by
 <a href="http://marc.info/">Marc</a>.
</p>

<h2>Mailing List Posting guidelines</h2>

<p>
 When posting to mailing lists or newsgroups, please keep the following in mind:
</p>

<ul>
 <li>
  Use a valid email address. Every new poster's email address
  is checked for validity through confirmation.
 </li>
 <li>
  Send plain ASCII messages, no HTML-formatted emails please.
 </li>
 <li>
  Turn on word wrapping so your entire message doesn't show up on
  a single line.
 </li>
 <li>
  Be sure to click <strong>Reply-All</strong> to reply to list. Clicking
  <strong>Reply</strong> will email the author of the message privately.
 </li>
 <li>
  No attachments please, just post a URL if you want someone to
  look at something.
 </li>
 <li>
  Don't GPG/PGP sign your messages. If you want people to be able
  to send you encrypted email, stick your key-locator in your signature
 </li>
 <li>
  Don't hijack other peoples' threads. To post on a new topic, start
  a new message, don't reply and just change the subject.
 </li>
 <li>
  Check the archives before posting a question, chances are it has
  already been asked and answered a few times.
 </li>
 <li>
  When asking a question, don't just tell us, &quot;it doesn't work&quot;.
  Tell us what you are trying to accomplish, a <strong>short</strong> code
  snippet showing how you tried to solve it, what you expected to get and
  what you got instead.
 </li>
</ul>
<p>
 And make sure you have read our
 <a href="https://github.com/php/php-src/blob/master/docs/mailinglist-rules.md">Mailinglist Rules</a>.
</p>
<?php

  // array of lists (list, name, short desc., moderated, archive, digest, newsgroup)
  $general_mailing_lists = [

      'General mailing lists for PHP users',
      [
          'php-announce', 'Announcements',
          'Announcements of new PHP releases are sent to this very low-volume list',
          true, false, false, "php.announce",
      ],
      [
          'php-general', 'General user list',
          'This is a high volume list for general PHP support; ask PHP questions here',
          false, true, true, "php.general",
      ],
      [
          'php-windows', 'Windows PHP users list',
          'Using PHP on Microsoft Windows',
          false, true, true, "php.windows",
      ],

      'Subject specific lists for PHP users',
      [
          'php-install', 'Installation issues and problems',
          'How to install PHP with particular configurations and servers',
          false, true, true, "php.install",
      ],
      [
          'php-db', 'Databases and PHP',
          'This list is for the discussion of PHP database topics',
          false, true, true, "php.db",
      ],
      'Non-English language mailing lists',
      [
          'php-es', 'Spanish PHP Mailing list',
          'List for Spanish speaking people interested in PHP',
          false, false, false, 'php.general.es',
      ],

  ];

  // array of lists (list, name, short desc., moderated, archive, digest, newsgroup)
  $internals_mailing_lists = [

      'PHP and Zend Engine internals lists',
      [
          'internals', 'Internals list',
          'A medium volume list for those who want to help out with the development of PHP',
          false, 'php-internals', true, "php.internals",
      ],
      [
          'internals-win', 'Windows Internals list',
          'A low volume list for those who want to help out with the development of PHP on Windows',
          false, false, true, "php.internals.win",
      ],
      [
          'php-cvs', 'Git commit list',
          'All commits to internals (php-src) and the Zend Engine are posted to this list automatically',
          true, true, false, "php.cvs",
      ],
      [
          'git-pulls', 'Git pull requests',
          'Pull requests from Github',
          false, false, false, "php.git-pulls",
      ],
      [
          'php-qa', 'Quality Assurance list',
          'List for the members of the PHP-QA Team',
          false, true, false, "php.qa",
      ],
      [
          'php-bugs', 'General bugs',
          'General bug activity are posted here',
          false, false, false, "php.bugs",
      ],
      [
          'standards', 'PHP Standardization and interoperability list',
          'Development of language standards',
          false, false, false, "php.standards",
      ],

      'PHP internal website mailing lists',
      [
          'php-webmaster', 'PHP php.net internal infrastructure discussion',
          'List for discussing and maintaining the php.net web infrastructure.<br>
       For general PHP support questions, see "General Mailing Lists" or the <a href="/support.php">support page</a>',
          false, false, false, "php.webmaster",
      ],

      'PHP documentation mailing lists',
      [
          'phpdoc', 'Documentation discussion',
          'List for discussing the PHP documentation',
          false, true, false, "php.doc",
      ],
      [
          'doc-cvs', 'Documentation changes and commits',
          'Changes to the documentation are posted here',
          true, "php-doc-cvs", false, "php.doc.cvs",
      ],
      [
          'doc-bugs', 'Documentation bugs',
          'Documentation bug activity (translations, sources, and build system) are posted here',
          true, 'php-doc-bugs', false, "php.doc.bugs",
      ],
  ];

// Print out a table for a given list array
function output_lists_table($mailing_lists): void
{
    echo '<table cellpadding="5" border="0" class="standard mailing-lists">', "\n";
    foreach ($mailing_lists as $listinfo) {
        if (!is_array($listinfo)) {
            echo "<tr><th>{$listinfo}</th><th>Moderated</th><th>Archive</th>" .
                 "<th>Newsgroup</th><th>Normal</th><th>Digest</th></tr>\n";
        } else {
            echo '<tr align="center">';
            echo '<td align="left"><strong>' . $listinfo[1] . '</strong> <small>&lt;<a href="mailto:' . $listinfo[0] . '@lists.php.net">' . $listinfo[0] . '@lists.php.net</a>&gt;</small><br><small>' . $listinfo[2] . '</small></td>';
            echo '<td>' . ($listinfo[3] ? 'yes' : 'no') . '</td>';

            // Let the list name defined with a string, if the
            // list is archived under a different name then php.net
            // uses for it (for backward compatibilty for example)
            if ($listinfo[4] !== false) {
                $larchive = ($listinfo[4] === true ? $listinfo[0] : $listinfo[4]);
            } else { $larchive = false; }
            echo '<td>' . ($larchive ? "<a href=\"http://marc.info/?l={$larchive}\">yes</a>" : 'n/a') . '</td>';
            echo '<td>' . ($listinfo[6] ? "<a href=\"news://news.php.net/{$listinfo[6]}\">yes</a> <a href=\"http://news.php.net/group.php?group={$listinfo[6]}\">http</a>" : 'n/a') . '</td>';
            echo '<td><input name="maillist" type="radio" value="' . $listinfo[0] . '"></td>';
            echo '<td>' . ($listinfo[5] ? '<input name="maillist" type="radio" value="' . $listinfo[0] . '-digest">' : 'n/a') . '</td>';
            echo "</tr>\n";
        }
    }
    echo "</table>\n";
}

?>

<form method="post" action="/mailing-lists.php">

<h2 id="general">General Mailing Lists</h2>

<?php output_lists_table($general_mailing_lists); ?>

<h2 id="internals">Internals Mailing Lists</h2>

<?php output_lists_table($internals_mailing_lists); ?>

<p class="center">
 <strong>Email:</strong>
 <input type="text" name="email" size="40" value="user@example.com">
 <input type="submit" name="action" value="Subscribe">
 <input type="submit" name="action" value="Unsubscribe">
</p>

</form>

<p>
 You will be sent a confirmation mail at the address you wish to
 be subscribed or unsubscribed, and only added to the list after
 following the directions in that mail.
</p>

<p>
 <strong>Warning:</strong> The PHP users mailing list gets close to 1500-2000
 messages per month currently. Do the math. That translates to about 60
 messages per day. If your mailbox can't handle this sort of traffic you
 might want to consider subscribing to the digest list instead (two messages
 per day), using the news server, or reading the mailing list using the
 archives.
</p>

<h2>Subscribe via Email</h2>

<p>
 If you experience trouble subscribing via the form above, you may also
 subscribe by sending an email to the list server.
 To subscribe to any mailing list, send an email to
 <code><em>listname</em>+subscribe@lists.php.net</code>
 (substituting the name of the list for <code><em>listname</em></code>
 &mdash; for example, <code>php-general+subscribe@lists.php.net</code>).
</p>

<h2>Mailing list options</h2>

<p>
 All of the mailing lists hosted at <a
 href="http://lists.php.net/">lists.php.net</a> are managed using the <a
 href="http://mlmmj.org/">mlmmj</a> mailing list software.
 There are a variety of commands you can use to modify your subscription.
 For a full overview, send a message to <code>php-whatever+help@lists.php.net</code> (as in,
 <code>php-general+help@lists.php.net</code>).</a>
</p>

<h3>Subscribing</h3>

<ul>
	<li>The normal mailing list, where you receive every message seperately:<br/>
	Email: <code>php-<em>listname</em>+subscribe@lists.php.net</code></li>
	<li>The daily digest list, where you receive an email with every message for a whole day at once:<br/>
	Email: <code>php-<em>listname</em>+subscribe<b>-digest</b>@lists.php.net</code></li>
	<li>The no email list, where you receive no emails from the list, but you can still post to it:<br/>
	Email: <code>php-<em>listname</em>+subscribe<b>-nomail</b>@lists.php.net</code></li>
</ul>

<h3>Unsubscribing</h3>

<p>
Email: <code>php-<em>listname</em>+unsubscribe@lists.php.net</code>
</p>

<h3>Help</h3>

<ul>
	<li>For a FAQ (Frequently Asked Questions):<br/>
	Email: <code>php-<em>listname</em>+help@lists.php.net</code></li>
	<li>To reach an administrator:<br/>
	Email: <code>php-<em>listname</em>+owner@lists.php.net</code></li>
</ul>


<?php site_footer(); ?>