re-add docs build script

Author: eli-darkly

.gitignore

@@ -4,5 +4,6 @@ composer.phar
 .php_cs.cache
 composer.lock
 docs/build
+docs/.phpdoc
 phpunit/
 .phpunit.result.cache

.ldrelease/build-docs.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# This script assumes that it is running in a Docker container using the image
+# "ldcircleci/php-sdk-release", defined in https://github.com/launchdarkly/sdks-ci-docker
+
+set -e
+
+cd docs
+make

.ldrelease/config.yml

@@ -4,7 +4,8 @@ publications:
 
 circleci:
   linux:
-    image: ldcircleci/ld-php-sdk-release:1  # built in sdks-ci-docker project, contains PHP 7.2 + phpDocumentor
+    image: ldcircleci/php-sdk-release:1  # built in sdks-ci-docker project, contains PHP 7.3 + phpDocumentor
 
 documentation:
   githubPages: true
+  title: LaunchDarkly PHP SDK phpredis integration

.ldrelease/publish-docs.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+set -e
+
+# Releaser will publish the docs to GitHub pages for us if we put a "docs.zip" artifact in ./artifacts
+
+mkdir -p artifacts
+pushd docs/build/html
+rm -f docs.zip
+zip -r docs.zip *
+popd
+mv docs/build/html/docs.zip artifacts

docs/Makefile

@@ -0,0 +1,14 @@
+
+SOURCE_DIR = $(shell cd .. && pwd)
+PHPDOCUMENTOR = php $(LDTOOLS_DIR)/php/phpDocumentor.phar
+
+.PHONY: html
+
+html:
+	rm -rf build/temp build/html
+	$(PHPDOCUMENTOR) \
+		-d $(SOURCE_DIR)/src \
+		-t build/html \
+		--visibility public \
+		--defaultpackagename "SDK" \
+		--title "${LD_RELEASE_DOCS_TITLE} ${LD_RELEASE_VERSION}"

src/LaunchDarkly/Impl/Integrations/PHPRedisFeatureRequester.php

@@ -3,6 +3,9 @@
 
 use LaunchDarkly\Impl\Integrations\FeatureRequesterBase;
 
+/**
+ * @internal
+ */
 class PHPRedisFeatureRequester extends FeatureRequesterBase
 {
     /** @var array */