nextcloud-gpodder/lib/Core/PodcastData/PodcastData.php
kalle (jag) 3a84b2506b Apply suggestions from code review
Co-authored-by: Jonathan Flueren <11487762+JonOfUs@users.noreply.github.com>
2022-10-28 09:50:44 +02:00

181 lines
3.6 KiB
PHP

<?php
declare(strict_types=1);
namespace OCA\GPodderSync\Core\PodcastData;
use DateTime;
use JsonSerializable;
use SimpleXMLElement;
class PodcastData implements JsonSerializable {
private ?string $title;
private ?string $author;
private ?string $link;
private ?string $description;
private ?string $imageUrl;
private int $fetchedAtUnix;
private ?string $imageBlob;
public function __construct(
?string $title,
?string $author,
?string $link,
?string $description,
?string $imageUrl,
int $fetchedAtUnix,
?string $imageBlob = null
) {
$this->title = $title;
$this->author = $author;
$this->link = $link;
$this->description = $description;
$this->imageUrl = $imageUrl;
$this->fetchedAtUnix = $fetchedAtUnix;
$this->imageBlob = $imageBlob;
}
/**
* @return PodcastData
* @throws Exception if the XML data could not be parsed.
*/
public static function parseRssXml(string $xmlString, ?int $fetchedAtUnix = null): PodcastData {
$xml = new SimpleXMLElement($xmlString);
$channel = $xml->channel;
return new PodcastData(
self::stringOrNull($channel->title),
self::getXPathContent($xml, '/rss/channel/itunes:author'),
self::stringOrNull($channel->link),
self::stringOrNull($channel->description),
self::getXPathContent($xml, '/rss/channel/image/url')
?? self::getXPathAttribute($xml, '/rss/channel/itunes:image/@href'),
$fetchedAtUnix ?? (new DateTime())->getTimestamp()
);
}
private static function stringOrNull($value): ?string {
if ($value) {
return (string)$value;
}
return null;
}
private static function getXPathContent(SimpleXMLElement $xml, string $xpath): ?string {
$match = $xml->xpath($xpath);
if ($match) {
return (string)$match[0];
}
return null;
}
private static function getXPathAttribute(SimpleXMLElement $xml, string $xpath): ?string {
$match = $xml->xpath($xpath);
if ($match) {
return (string)$match[0][0];
}
return null;
}
/**
* @return string|null
*/
public function getTitle(): ?string {
return $this->title;
}
/**
* @return string|null
*/
public function getAuthor(): ?string {
return $this->author;
}
/**
* @return string|null
*/
public function getLink(): ?string {
return $this->link;
}
/**
* @return string|null
*/
public function getDescription(): ?string {
return $this->description;
}
/**
* @return string|null
*/
public function getImageUrl(): ?string {
return $this->imageUrl;
}
/**
* @return int|null
*/
public function getFetchedAtUnix(): ?int {
return $this->fetchedAtUnix;
}
/**
* @return string|null
*/
public function getImageBlob(): ?string {
return $this->imageBlob;
}
/**
* @param string $blob
* @return void
*/
public function setImageBlob(?string $blob): void {
$this->imageBlob = $blob;
}
/**
* @return string
*/
public function __toString() : string {
return $this->title ?? '/no title/';
}
/**
* @return array<string,mixed>
*/
public function toArray(): array {
return
[
'title' => $this->title,
'author' => $this->author,
'link' => $this->link,
'description' => $this->description,
'imageUrl' => $this->imageUrl,
'imageBlob' => $this->imageBlob,
'fetchedAtUnix' => $this->fetchedAtUnix,
];
}
/**
* @return array<string,mixed>
*/
public function jsonSerialize(): array {
return $this->toArray();
}
/**
* @return PodcastData
*/
public static function fromArray(array $data): PodcastData {
return new PodcastData(
$data['title'],
$data['author'],
$data['link'],
$data['description'],
$data['imageUrl'],
$data['fetchedAtUnix'],
$data['imageBlob']
);
}
}