|Album|Artist|Playlist $mixed * * @throws Exception * * @return string Full path to the generated archive */ public function from($mixed) { if (is_a($mixed, Song::class)) { return $this->fromSong($mixed); } elseif (is_a($mixed, Collection::class)) { return $this->fromMultipleSongs($mixed); } elseif (is_a($mixed, Album::class)) { return $this->fromAlbum($mixed); } elseif (is_a($mixed, Artist::class)) { return $this->fromArtist($mixed); } elseif (is_a($mixed, Playlist::class)) { return $this->fromPlaylist($mixed); } else { throw new Exception('Unsupport download type.'); } } /** * Generate the downloadable path for a song. * * @param Song $song * * @return string */ protected function fromSong(Song $song) { if ($s3Params = $song->s3_params) { // The song is hosted on Amazon S3. // We download it back to our local server first. $localPath = rtrim(sys_get_temp_dir(), '/').'/'.basename($s3Params['key']); $url = $song->getObjectStoragePublicUrl(); abort_unless($url, 404); // The following function require allow_url_fopen to be ON. // We're just assuming that to be the case here. copy($url, $localPath); } else { // The song is hosted locally. Make sure the file exists. abort_unless(file_exists($song->path), 404); $localPath = $song->path; } // The BinaryFileResponse factory only accept ASCII-only file names. if (ctype_print($localPath)) { return $localPath; } // For those with high-byte characters in names, we copy it into a safe name // as a workaround. $newPath = rtrim(sys_get_temp_dir(), '/').'/'.utf8_decode(basename($song->path)); if ($s3Params) { // If the file is downloaded from S3, we rename it directly. // This will save us some disk space. rename($localPath, $newPath); } else { // Else we copy it to another file to not mess up the original one. copy($localPath, $newPath); } return $newPath; } /** * Generate a downloadable path of multiple songs in zip format. * * @param Collection $songs * * @throws Exception * * @return string */ protected function fromMultipleSongs(Collection $songs) { if ($songs->count() === 1) { return $this->fromSong($songs->first()); } if (!class_exists('ZipArchive')) { throw new Exception('Downloading multiple files requires ZipArchive module.'); } // Start gathering the songs into a zip file. $zip = new ZipArchive(); // We use system's temp dir instead of storage_path() here, so that the generated files // can be cleaned up automatically after server reboot. $filename = rtrim(sys_get_temp_dir(), '/').'/koel-download-'.uniqid().'.zip'; if ($zip->open($filename, ZipArchive::CREATE) !== true) { throw new Exception('Cannot create zip file.'); } $localNames = [ // The data will follow this format: // 'duplicated-name.mp3' => currentFileIndex ]; $songs->each(function ($s) use ($zip, &$localNames) { try { $path = $this->fromSong($s); // We add all files into the zip archive as a flat structure. // As a result, there can be duplicate file names. // The following several lines are to make sure each file name is unique. $name = basename($path); if (array_key_exists($name, $localNames)) { ++$localNames[$name]; $parts = explode('.', $name); $ext = $parts[count($parts) - 1]; $parts[count($parts) - 1] = $localNames[$name].".$ext"; $name = implode('.', $parts); } else { $localNames[$name] = 1; } $zip->addFile($path, $name); } catch (Exception $e) { Log::error($e); } }); $zip->close(); return $filename; } protected function fromPlaylist(Playlist $playlist) { return $this->fromMultipleSongs($playlist->songs); } protected function fromAlbum(Album $album) { return $this->fromMultipleSongs($album->songs); } protected function fromArtist(Artist $artist) { // Don't forget the contributed songs. $songs = $artist->songs->merge($artist->getContributedSongs()); return $this->fromMultipleSongs($songs); } }