Sur cette page

QHttpServerConfiguration Class

La classe QHttpServerConfiguration contrôle les paramètres du serveur. Plus d'informations...

En-tête : #include <QHttpServerConfiguration>
CMake : find_package(Qt6 REQUIRED COMPONENTS HttpServer)
target_link_libraries(mytarget PRIVATE Qt6::HttpServer)
qmake : QT += httpserver
Depuis : Qt 6.9

Fonctions publiques

QHttpServerConfiguration()
QHttpServerConfiguration(const QHttpServerConfiguration &other)
QHttpServerConfiguration(QHttpServerConfiguration &&other)
~QHttpServerConfiguration()
(since 6.10) QSpan<const std::pair<QHostAddress, int>> blacklist() const
(since 6.10) std::chrono::seconds keepAliveTimeout() const
(since 6.11) qint64 maximumBodySize() const
(since 6.11) qint64 maximumHeaderFieldCount() const
(since 6.11) qint64 maximumHeaderFieldSize() const
(since 6.11) qint64 maximumTotalHeaderSize() const
(since 6.11) qint64 maximumUrlSize() const
quint32 rateLimitPerSecond() const
(since 6.10) void setBlacklist(QSpan<const std::pair<QHostAddress, int>> subnetList)
(since 6.10) void setKeepAliveTimeout(std::chrono::seconds timeout)
(since 6.11) void setMaximumBodySize(qint64 maxSize)
(since 6.11) void setMaximumHeaderFieldCount(qint64 maxSize)
(since 6.11) void setMaximumHeaderFieldSize(qint64 maxSize)
(since 6.11) void setMaximumTotalHeaderSize(qint64 maxSize)
(since 6.11) void setMaximumUrlSize(qint64 maxSize)
void setRateLimitPerSecond(quint32 maxRequests)
(since 6.10) void setWhitelist(QSpan<const std::pair<QHostAddress, int>> subnetList)
void swap(QHttpServerConfiguration &other)
(since 6.10) QSpan<const std::pair<QHostAddress, int>> whitelist() const
QHttpServerConfiguration &operator=(QHttpServerConfiguration &&other)
QHttpServerConfiguration &operator=(const QHttpServerConfiguration &other)
bool operator!=(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)
bool operator==(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)

Description détaillée

Documentation des fonctions membres

QHttpServerConfiguration::QHttpServerConfiguration()

Default construit un objet QHttpServerConfiguration.

Une telle configuration a les valeurs suivantes :

  • La limite de débit est désactivée

QHttpServerConfiguration::QHttpServerConfiguration(const QHttpServerConfiguration &other)

Copie-construit cette QHttpServerConfiguration.

[constexpr noexcept] QHttpServerConfiguration::QHttpServerConfiguration(QHttpServerConfiguration &&other)

Move-construit cette QHttpServerConfiguration à partir de other

[noexcept] QHttpServerConfiguration::~QHttpServerConfiguration()

Destructeur.

[since 6.10] QSpan<const std::pair<QHostAddress, int>> QHttpServerConfiguration::blacklist() const

Renvoie la liste noire des sous-réseaux dont l'accès est refusé par QHttpServer.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi setBlacklist().

[since 6.10] std::chrono::seconds QHttpServerConfiguration::keepAliveTimeout() const

Renvoie le délai de maintien en vie utilisé par QHttpServer.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi setKeepAliveTimeout().

[since 6.11] qint64 QHttpServerConfiguration::maximumBodySize() const

Renvoie la taille maximale du corps entrant accepté par le serveur.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setMaximumBodySize().

[since 6.11] qint64 QHttpServerConfiguration::maximumHeaderFieldCount() const

Renvoie le nombre maximum de champs d'en-tête acceptés par le serveur.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setMaximumHeaderFieldCount().

[since 6.11] qint64 QHttpServerConfiguration::maximumHeaderFieldSize() const

Renvoie la taille maximale des en-têtes entrants acceptés par le serveur.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setMaximumHeaderFieldSize().

[since 6.11] qint64 QHttpServerConfiguration::maximumTotalHeaderSize() const

Renvoie la taille maximale de l'ensemble des en-têtes entrants acceptés par le serveur.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setMaximumTotalHeaderSize().

[since 6.11] qint64 QHttpServerConfiguration::maximumUrlSize() const

Renvoie la taille maximale de l'URL acceptée par le serveur.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setMaximumUrlSize().

quint32 QHttpServerConfiguration::rateLimitPerSecond() const

Renvoie le nombre maximum de requêtes entrantes par seconde et par IP acceptées par le serveur.

Voir aussi setRateLimitPerSecond().

[since 6.10] void QHttpServerConfiguration::setBlacklist(QSpan<const std::pair<QHostAddress, int>> subnetList)

Définit subnetList comme liste noire de sous-réseaux.

Les adresses IP figurant sur cette liste se verront refuser l'accès par QHttpServer. La liste noire n'est active que lorsque la liste blanche est vide.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi blacklist(), setWhitelist() et QHostAddress::parseSubnet().

[since 6.10] void QHttpServerConfiguration::setKeepAliveTimeout(std::chrono::seconds timeout)

Définit timeout comme délai d'attente pour QHttpServer.

Le délai de maintien en vie détermine la durée pendant laquelle une connexion inactive est maintenue ouverte avant d'être fermée. Par défaut, le délai est fixé à 15 secondes.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keepAliveTimeout().

[since 6.11] void QHttpServerConfiguration::setMaximumBodySize(qint64 maxSize)

Fixe à maxSize la taille maximale du corps du message que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 413 Content Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 32 MiB.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi maximumBodySize() et QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumHeaderFieldCount(qint64 maxSize)

Fixe à maxSize le nombre maximum de champs d'en-tête acceptés par le serveur. Si la limite est dépassée, QHttpServer répondra avec le statut 431 Request Header Fields Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est 128.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi maximumHeaderFieldCount() et QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumHeaderFieldSize(qint64 maxSize)

Fixe à maxSize la taille maximale d'un seul en-tête que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 431 Request Header Fields Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 48 KiB.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi maximumHeaderFieldSize() et QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumTotalHeaderSize(qint64 maxSize)

Fixe à maxSize la taille totale maximale des en-têtes que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 431 Request Header Fields Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 64 KiB.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi maximumTotalHeaderSize() et QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumUrlSize(qint64 maxSize)

Fixe à maxSize la taille maximale de l'URL que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 414 Request-URI Too Long. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 64 KiB.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi maximumUrlSize() et QHttpServerResponder::StatusCode.

void QHttpServerConfiguration::setRateLimitPerSecond(quint32 maxRequests)

Fixe à maxRequests le nombre maximum de requêtes entrantes par seconde et par IP qui seront acceptées par QHttpServer. Si la limite est dépassée, QHttpServer répondra par QHttpServerResponder::StatusCode::TooManyRequests.

Voir aussi rateLimitPerSecond() et QHttpServerResponder::StatusCode.

[since 6.10] void QHttpServerConfiguration::setWhitelist(QSpan<const std::pair<QHostAddress, int>> subnetList)

Définit subnetList comme liste blanche des sous-réseaux autorisés.

Si la liste n'est pas vide, seules les adresses IP figurant dans cette liste seront autorisées par QHttpServer. La liste blanche est prioritaire sur la liste noire.

Chaque sous-réseau est représenté par une paire composée de :

  • une adresse IP de base de type QHostAddress.
  • Une longueur de préfixe CIDR de type int, qui définit le masque de sous-réseau.

Pour n'autoriser qu'une adresse IP spécifique, utilisez une longueur de préfixe de 32 pour IPv4 (par exemple, "192.168.1.100/32") ou de 128 pour IPv6 (par exemple, "2001:db8::1/128").

Cette fonction a été introduite dans Qt 6.10.

Voir aussi whitelist(), setBlacklist(), et QHostAddress::parseSubnet().

[noexcept] void QHttpServerConfiguration::swap(QHttpServerConfiguration &other)

Remplace cette configuration par other. Cette opération est très rapide et n'échoue jamais.

[since 6.10] QSpan<const std::pair<QHostAddress, int>> QHttpServerConfiguration::whitelist() const

Renvoie la liste blanche des sous-réseaux autorisés par QHttpServer.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi setWhitelist().

[noexcept] QHttpServerConfiguration &QHttpServerConfiguration::operator=(QHttpServerConfiguration &&other)

Move-assigns other to this QHttpServerConfiguration.

QHttpServerConfiguration &QHttpServerConfiguration::operator=(const QHttpServerConfiguration &other)

Copie-assignation de other à ce QHttpServerConfiguration.

Non-membres apparentés

[noexcept] bool operator!=(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)

Renvoie true si lhs et rhs n'ont pas le même ensemble de paramètres de configuration.

[noexcept] bool operator==(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)

Renvoie true si lhs et rhs ont le même ensemble de paramètres de configuration.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.